javax.ws.rs.ext.ProviderFactory Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jsr311-api
There is a newer version: 1.1.1
/*
 * The contents of this file are subject to the terms
 * of the Common Development and Distribution License
 * (the "License").  You may not use this file except
 * in compliance with the License.
 * 
 * You can obtain a copy of the license at
 * http://www.opensource.org/licenses/cddl1.php
 * See the License for the specific language governing
 * permissions and limitations under the License.
 */

/*
 * ProviderFactory.java
 *
 * Created on May 16, 2007, 12:01 PM
 *
 */

package javax.ws.rs.ext;
 
import java.util.Iterator;
import java.util.List;
import java.util.concurrent.atomic.AtomicReference;
import sun.misc.Service;

/**
 * Factory for creating instances of provider classes.
 */
public abstract class ProviderFactory {
    
    private static AtomicReference pfr = new AtomicReference();
    
    /** 
     * Get an instance of ProviderFactory. The implementation of
     * ProviderFactory that will be instantiated is determined using the 
     * Services API (as detailed in the JAR specification) to determine
     * the classname. The Services API will look for a classname in the file
     * META-INF/services/javax.ws.rs.ext.ProviderFactory in jars available
     * to the runtime.
     */
    public static ProviderFactory getInstance() {
       ProviderFactory pf = pfr.get();
       if (pf != null)
           return pf;
       Iterator ps = Service.providers(ProviderFactory.class); 
       while (ps.hasNext()) { 
           pf = (ProviderFactory)ps.next();
           pfr.set(pf);
           break;
       }
       return pf;
    }
    
    /**
     * Create a new instance of a provider for the specified interface.
     * @param type the type of provider
     * @return a new provider instance
     */
    public abstract  T createInstance(Class type);

    /**
     * Create a new instance of a HeaderProvider for the specified class.
     * @param type the type of value class used to represent the header
     * @return a new provider instance
     */
    public abstract  HeaderProvider createHeaderProvider(Class type);

    /**
     * Create a new instance of an EntityProvider for the specified class.
     * @param type the type of value class used to represent the entity
     * @return a new provider instance
     */
    public abstract  EntityProvider createEntityProvider(Class type);
}