com.linecorp.armeria.server.docs

Class ServiceSpecification

java.lang.Object

com.linecorp.armeria.server.docs.ServiceSpecification

@UnstableApi
public final class ServiceSpecification
extends Object

The specification of one or more Services that provides their ServiceInfos and NamedTypeInfos.

Constructor Summary

Constructors

Constructor and Description
ServiceSpecification(Iterable<ServiceInfo> services, Iterable<EnumInfo> enums, Iterable<StructInfo> structs, Iterable<ExceptionInfo> exceptions) Creates a new instance.
ServiceSpecification(Iterable<ServiceInfo> services, Iterable<EnumInfo> enums, Iterable<StructInfo> structs, Iterable<ExceptionInfo> exceptions, Iterable<HttpHeaders> exampleHttpHeaders) Creates a new instance.

Method Summary

Modifier and Type	Method and Description
Set<EnumInfo>	enums() Returns the metadata about the enums related with the services in this specification.
List<HttpHeaders>	exampleHttpHeaders() Returns the example HTTP headers of the services in this specification.
Set<ExceptionInfo>	exceptions() Returns the metadata about the exceptions related with the services in this specification.
static ServiceSpecification	generate(Iterable<ServiceInfo> services, Function<TypeSignature,? extends NamedTypeInfo> namedTypeInfoFactory) Generates a new ServiceSpecification from the specified ServiceInfos and the factory Function that creates NamedTypeInfos for the enum, struct or exception types referred by the specified ServiceInfos.
static ServiceSpecification	merge(Iterable<ServiceSpecification> specs) Merges the specified ServiceSpecifications into one.
Set<ServiceInfo>	services() Returns the metadata about the services in this specification.
Set<StructInfo>	structs() Returns the metadata about the structs related with the services in this specification.

Methods inherited from class java.lang.Object

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

Constructor Detail

ServiceSpecification

public ServiceSpecification(Iterable<ServiceInfo> services,
                            Iterable<EnumInfo> enums,
                            Iterable<StructInfo> structs,
                            Iterable<ExceptionInfo> exceptions)

Creates a new instance.

ServiceSpecification

public ServiceSpecification(Iterable<ServiceInfo> services,
                            Iterable<EnumInfo> enums,
                            Iterable<StructInfo> structs,
                            Iterable<ExceptionInfo> exceptions,
                            Iterable<HttpHeaders> exampleHttpHeaders)

Creates a new instance.

Method Detail

merge

public static ServiceSpecification merge(Iterable<ServiceSpecification> specs)

Merges the specified ServiceSpecifications into one.

generate

public static ServiceSpecification generate(Iterable<ServiceInfo> services,
                                            Function<TypeSignature,? extends NamedTypeInfo> namedTypeInfoFactory)

Generates a new ServiceSpecification from the specified ServiceInfos and the factory Function that creates NamedTypeInfos for the enum, struct or exception types referred by the specified ServiceInfos.

services

public Set<ServiceInfo> services()

Returns the metadata about the services in this specification.

enums

public Set<EnumInfo> enums()

Returns the metadata about the enums related with the services in this specification.

structs

public Set<StructInfo> structs()

Returns the metadata about the structs related with the services in this specification.

exceptions

public Set<ExceptionInfo> exceptions()

Returns the metadata about the exceptions related with the services in this specification.

exampleHttpHeaders

public List<HttpHeaders> exampleHttpHeaders()

Returns the example HTTP headers of the services in this specification.