Package org.immutables.metainf

Annotation Type Metainf.Service

Enclosing class:
Metainf
@Documented @Retention(SOURCE) public static @interface Metainf.Service
META-INF/services/<interface.fully.qualified.name> entries in classpath will be generated with fully qualified name of annotated class as content line. Multiple meta-services by the same interface will end up on separate lines in the same meta-inf service file.

Most other such generators either allow only single service type to be specified or just do autodetection of all interfaces. This generator supports autodetection of implemented inter (the default) or to override with one or more specific interfaces or classes. 

 package a;
 @Provider
 @Metainf.Service
 public class JaxrsMessageBodyProvider implements MessageBodyReader<Object>, MessageBodyWriter<Object> {
 ...
 }
Both META-INF/services/javax.ws.rs.ext.MessageBodyReader and META-INF/services/javax.ws.rs.ext.MessageBodyWriter will be generated and will contain line with fully qualified class name of a.JaxrsMessageBodyProvider. 
 package b;
 @Provider
 @Metainf.Service(javax.ws.rs.ext.MessageBodyReader.class)
 public class JaxrsMessageBodyReader extends JaxrsMessageBodyProvider {
 ...
 }
Only META-INF/services/javax.ws.rs.ext.MessageBodyReader will be generated and will contain b.JaxrsMessageBodyReader line. If JaxrsMessageBodyReader and JaxrsMessageBodyProvider will be compiled together, then META-INF/services/javax.ws.rs.ext.MessageBodyReader file will have merged content, i.e. it will contain two lines: 
 a.JaxrsMessageBodyProvider
 b.JaxrsMessageBodyReader

See Also:

  • Optional Element Summary

    Optional Elements
    Modifier and Type
    Optional Element
    Description
    Class<?>[]
    value
    If value() attribute is empty (as by default) all implemented interfaces will be taken into account, otherwise only specified implemented classes will be used.

  • Element Details

    • value

      Class<?>[] value
      If value() attribute is empty (as by default) all implemented interfaces will be taken into account, otherwise only specified implemented classes will be used.
      Returns:
      service interfaces or abstract classes.
      Default:
      {}