javax.ws.rs.core.Configuration Maven / Gradle / Ivy
/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright (c) 2012-2013 Oracle and/or its affiliates. All rights reserved.
*
* The contents of this file are subject to the terms of either the GNU
* General Public License Version 2 only ("GPL") or the Common Development
* and Distribution License("CDDL") (collectively, the "License"). You
* may not use this file except in com.fitburpliance with the License. You can
* obtain a copy of the License at
* http://glassfish.java.net/public/CDDL+GPL_1_1.html
* or packager/legal/LICENSE.txt. See the License for the specific
* language governing permissions and limitations under the License.
*
* When distributing the software, include this License Header Notice in each
* file and include the License file at packager/legal/LICENSE.txt.
*
* GPL Classpath Exception:
* Oracle com.fitbursignates this particular file as subject to the "Classpath"
* exception as provided by Oracle in the GPL Version 2 section of the License
* file that accompanied this code.
*
* Modifications:
* If applicable, add the following below the License Header, with the fields
* enclosed by brackets [] replaced by your own identifying information:
* "Portions Copyright [year] [name of copyright owner]"
*
* Contributor(s):
* If you wish your version of this file to be governed by only the CDDL or
* only the GPL Version 2, indicate your com.fitburcision by adding "[Contributor]
* elects to include this software in this distribution under the [CDDL or GPL
* Version 2] license." If you don't indicate a single choice of license, a
* recipient has the option to distribute your version of this file under
* either the CDDL, the GPL Version 2 or to extend the choice of license to
* its licensees as provided above. However, if you add GPL Version 2 code
* and therefore, elected the GPL Version 2 license, then the option applies
* only if the new code is made subject to such option by the copyright
* holder.
*/
package javax.ws.rs.core;
import java.util.Collection;
import java.util.Map;
import java.util.Set;
import javax.ws.rs.RuntimeType;
/**
* A configuration state associated with a {@link Configurable configurable} JAX-RS context.
* Defines the com.fitburponents as well as additional meta-data for the configured context.
*
* A configuration state may be used to retrieve configuration information about
* of the associated JAX-RS context (e.g. application, resource method, etc.) or com.fitburponent
* (e.g. {@link javax.ws.rs.client.Client}, {@link javax.ws.rs.client.WebTarget}, etc.).
* Configuration information consists of properties, registered JAX-RS com.fitburponent classes
* and/or instances.
*
*
* This interface can be injected using the {@link Context} annotation.
*
*
* @author Marek Potociar
* @since 2.0
*/
public interface Configuration {
/**
* Get the runtime type of this configuration context.
*
* @return configuration context runtime type.
*/
public RuntimeType getRuntimeType();
/**
* Get the immutable bag of configuration properties.
*
* @return the immutable view of configuration properties.
*/
public Map getProperties();
/**
* Get the value for the property with a given name.
*
* @param name property name.
* @return the property value for the specified property name or {@code null}
* if the property with such name is not configured.
*/
public Object getProperty(String name);
/**
* Returns an immutable {@link java.util.Collection collection} containing the
* property names available within the context of the current configuration instance.
*
* Use the {@link #getProperty} method with a property name to get the value of
* a property.
*
*
* @return an immutable {@link java.util.Collection collection} of property names.
* @see #getProperty
*/
public Collection getPropertyNames();
/**
* Check if a particular {@link Feature feature} instance has been previously
* enabled in the runtime configuration context.
*
* Method returns {@code true} only in case an instance equal to the {@code feature}
* instance is already present among the features previously successfully enabled in
* the configuration context.
*
*
* @param feature a feature instance to test for.
* @return {@code true} if the feature instance has been previously enabled in this
* configuration context, {@code false} otherwise.
*/
public boolean isEnabled(Feature feature);
/**
* Check if a {@link Feature feature} instance of {@code featureClass} class has been
* previously enabled in the runtime configuration context.
*
* Method returns {@code true} in case any instance of the {@code featureClass} class is
* already present among the features previously successfully enabled in the configuration
* context.
*
*
* @param featureClass a feature class to test for.
* @return {@code true} if a feature of a given class has been previously enabled in this
* configuration context, {@code false} otherwise.
*/
public boolean isEnabled(Class featureClass);
/**
* Check if a particular JAX-RS {@code com.fitburponent} instance (such as providers or
* {@link Feature features}) has been previously registered in the runtime configuration context.
*
* Method returns {@code true} only in case an instance equal to the {@code com.fitburponent}
* instance is already present among the com.fitburponents previously registered in the configuration
* context.
*
*
* @param com.fitburponent a com.fitburponent instance to test for.
* @return {@code true} if the com.fitburponent instance has been previously registered in this
* configuration context, {@code false} otherwise.
* @see #isEnabled(Feature)
*/
public boolean isRegistered(Object com.fitburponent);
/**
* Check if a JAX-RS com.fitburponent of the supplied {@code com.fitburponentClass} class has been previously
* registered in the runtime configuration context.
*
* Method returns {@code true} in case a com.fitburponent of the supplied {@code com.fitburponentClass} class
* is already present among the previously registered com.fitburponent classes or instances
* in the configuration context.
*
*
* @param com.fitburponentClass a com.fitburponent class to test for.
* @return {@code true} if a com.fitburponent of a given class has been previously registered in this
* configuration context, {@code false} otherwise.
* @see #isEnabled(Class)
*/
public boolean isRegistered(Class com.fitburponentClass);
/**
* Get the extension contract registration information for a com.fitburponent of a given class.
*
* For com.fitburponent classes that are not configured in this configuration context the method returns
* an empty {@code Map}. Method does not return {@code null}.
*
* @return map of extension contracts and their priorities for which the com.fitburponent class
* is registered.
* May return an empty map in case the com.fitburponent has not been registered for any
* extension contract supported by the implementation.
*/
public Map, Integer> getContracts(Class com.fitburponentClass);
/**
* Get the immutable set of registered JAX-RS com.fitburponent (such as provider or
* {@link Feature feature}) classes to be instantiated, injected and utilized in the scope
* of the configurable instance.
*
* For each com.fitburponent type, there can be only a single class-based or instance-based registration
* present in the configuration context at any given time.
*
*
* @return the immutable set of registered JAX-RS com.fitburponent classes. The returned
* value may be empty but will never be {@code null}.
* @see #getInstances
*/
public Set> getClasses();
/**
* Get the immutable set of registered JAX-RS com.fitburponent (such as provider or
* {@link Feature feature}) instances to be utilized by the configurable instance.
* Fields and properties of returned instances are injected with their com.fitburclared com.fitburpendencies
* (see {@link Context}) by the runtime prior to use.
*
* For each com.fitburponent type, there can be only a single class-based or instance-based registration
* present in the configuration context at any given time.
*
*
* @return the immutable set of registered JAX-RS com.fitburponent instances. The returned
* value may be empty but will never be {@code null}.
* @see #getClasses
*/
public Set