File	Doc	Category	Size	Date	Package
ServiceFinder.java	API Doc	Example	17603	Tue May 29 16:56:38 BST 2007	com.sun.xml.ws.policy.privateutil

ServiceFinder

• java.lang.Object

public abstract CharEncoder getEncoder(String encodingName);
public abstract CharDecoder getDecoder(String encodingName);

sun.io.StandardCodec # Standard codecs for the platform

CharEncoder getEncoder(String encodingName) {
for( CharCodec cc : ServiceFinder.find(CharCodec.class) ) {
CharEncoder ce = cc.getEncoder(encodingName);
if (ce != null)
return ce;
}
return null;
}

Fields Summary
private static final PolicyLogger	LOGGER
private static final String	prefix
private final Class	serviceClass
private final ClassLoader	classLoader

Constructors Summary
private ServiceFinder(Class service, ClassLoader loader) this.serviceClass = service; this.classLoader = loader;

Methods Summary
private static void	fail(java.lang.Class service, java.lang.String msg, java.lang.Throwable cause) final ServiceConfigurationError sce = new ServiceConfigurationError(LocalizationMessages.WSP_0025_SPI_FAIL_SERVICE_MSG(service.getName(), msg)); if (null != cause) { sce.initCause(cause); } throw LOGGER.logSevereException(sce);
private static void	fail(java.lang.Class service, java.net.URL u, int line, java.lang.String msg, java.lang.Throwable cause) fail(service, LocalizationMessages.WSP_0024_SPI_FAIL_SERVICE_URL_LINE_MSG(u , line, msg), cause);
static com.sun.xml.ws.policy.privateutil.ServiceFinder	find(java.lang.Class service, java.lang.ClassLoader loader) Locates and incrementally instantiates the available providers of a given service using the given class loader. This method transforms the name of the given service class into a provider-configuration filename as described above and then uses the getResources method of the given class loader to find all available files with that name. These files are then read and parsed to produce a list of provider-class names. The iterator that is returned uses the given class loader to lookup and then instantiate each element of the list. Because it is possible for extensions to be installed into a running Java virtual machine, this method may return different results each time it is invoked. param service The service's abstract service class param loader The class loader to be used to load provider-configuration files and instantiate provider classes, or null if the system class loader (or, failing that the bootstrap class loader) is to be used throws ServiceConfigurationError If a provider-configuration file violates the specified format or names a provider class that cannot be found and instantiated see #find(Class) if (null==service) { throw LOGGER.logSevereException(new NullPointerException(LocalizationMessages.WSP_0032_SERVICE_CAN_NOT_BE_NULL())); } return new ServiceFinder<T>(service,loader);
public static com.sun.xml.ws.policy.privateutil.ServiceFinder	find(java.lang.Class service) Locates and incrementally instantiates the available providers of a given service using the context class loader. This convenience method is equivalent to ClassLoader cl = Thread.currentThread().getContextClassLoader(); return Service.providers(service, cl); param service The service's abstract service class throws ServiceConfigurationError If a provider-configuration file violates the specified format or names a provider class that cannot be found and instantiated see #find(Class, ClassLoader) return find(service,Thread.currentThread().getContextClassLoader());
public java.util.Iterator	iterator() Returns discovered objects incrementally. return An Iterator that yields provider objects for the given service, in some arbitrary order. The iterator will throw a ServiceConfigurationError if a provider-configuration file violates the specified format or if a provider class cannot be found and instantiated. return new LazyIterator<T>(serviceClass,classLoader);
private static java.util.Iterator	parse(java.lang.Class service, java.net.URL u, java.util.Set returned) Parse the content of the given URL as a provider-configuration file. param service The service class for which providers are being sought; used to construct error detail strings param u The URL naming the configuration file to be parsed param returned A Set containing the names of provider classes that have already been returned. This set will be updated to contain the names that will be yielded from the returned Iterator. return A (possibly empty) Iterator that will yield the provider-class names in the given configuration file that are not yet members of the returned set throws ServiceConfigurationError If an I/O error occurs while reading from the given URL, or if a configuration-file format error is detected InputStream in = null; BufferedReader r = null; ArrayList<String> names = new ArrayList<String>(); try { in = u.openStream(); r = new BufferedReader(new InputStreamReader(in, "utf-8")); int lc = 1; while ((lc = parseLine(service, u, r, lc, names, returned)) >= 0) ; } catch (IOException x) { fail(service, ": " + x, x); } finally { try { if (r != null) r.close(); if (in != null) in.close(); } catch (IOException y) { fail(service, ": " + y, y); } } return names.iterator();
private static int	parseLine(java.lang.Class service, java.net.URL u, java.io.BufferedReader r, int lc, java.util.List names, java.util.Set returned) Parse a single line from the given configuration file, adding the name on the line to both the names list and the returned set iff the name is not already a member of the returned set. String ln = r.readLine(); if (ln == null) { return -1; } final int ci = ln.indexOf('#"); if (ci >= 0) ln = ln.substring(0, ci); ln = ln.trim(); final int n = ln.length(); if (n != 0) { if ((ln.indexOf(' ") >= 0) || (ln.indexOf('\t") >= 0)) fail(service, u, lc, LocalizationMessages.WSP_0067_ILLEGAL_CFG_FILE_SYNTAX(), null); int cp = ln.codePointAt(0); if (!Character.isJavaIdentifierStart(cp)) fail(service, u, lc, LocalizationMessages.WSP_0066_ILLEGAL_PROVIDER_CLASSNAME(ln), null); for (int i = Character.charCount(cp); i < n; i += Character.charCount(cp)) { cp = ln.codePointAt(i); if (!Character.isJavaIdentifierPart(cp) && (cp != '.")) fail(service, u, lc, LocalizationMessages.WSP_0066_ILLEGAL_PROVIDER_CLASSNAME(ln), null); } if (!returned.contains(ln)) { names.add(ln); returned.add(ln); } } return lc + 1;
public T[]	toArray() Returns discovered objects all at once. return can be empty but never null. throws ServiceConfigurationError List<T> result = new ArrayList<T>(); for (T t : this) { result.add(t); } return result.toArray((T[])Array.newInstance(serviceClass,result.size()));