com.linecorp.armeria.server.docs

Class DocService

java.lang.Object

com.linecorp.armeria.server.composition.AbstractCompositeService<HttpService,HttpRequest,HttpResponse>

com.linecorp.armeria.server.docs.DocService

All Implemented Interfaces:

Unwrappable, HttpService, Service<HttpRequest,HttpResponse>

public final class DocService
extends AbstractCompositeService<HttpService,HttpRequest,HttpResponse>
implements HttpService

An HttpService that provides information about the Services running in a Server. It does not require any configuration besides adding it to a VirtualHost; it discovers all the eligible Services automatically.

How is the documentation generated?

DocService looks up the DocServicePlugins available in the current JVM using Java SPI (Service Provider Interface). The DocServicePlugin implementations will generate ServiceSpecifications for the Services they support.

See Also:

DocServiceBuilder.include(DocServiceFilter), DocServiceBuilder.exclude(DocServiceFilter)

Constructor Summary

Constructors

Constructor and Description
DocService() Creates a new instance.

Method Summary

Modifier and Type	Method and Description
static DocServiceBuilder	builder() Returns a new DocServiceBuilder.
void	serviceAdded(ServiceConfig cfg) Invoked when this service has been added to a Server with the specified configuration.

Methods inherited from class com.linecorp.armeria.server.composition.AbstractCompositeService

findService, serve, serviceAt, services

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.linecorp.armeria.server.HttpService

decorate, decorate, serve

Methods inherited from interface com.linecorp.armeria.server.Service

as, decorate, shouldCachePath

Constructor Detail

DocService

public DocService()

Creates a new instance.

Method Detail

builder

public static DocServiceBuilder builder()

Returns a new DocServiceBuilder.

serviceAdded

public void serviceAdded(ServiceConfig cfg)
                  throws Exception

Description copied from interface: Service

Invoked when this service has been added to a Server with the specified configuration. Please note that this method can be invoked more than once if this service has been added more than once.

Specified by:

serviceAdded in interface Service<HttpRequest,HttpResponse>

Overrides:

serviceAdded in class AbstractCompositeService<HttpService,HttpRequest,HttpResponse>

Throws:

Exception