org.apache.abdera.util

Class ServiceUtil

java.lang.Object

org.apache.abdera.util.ServiceUtil

All Implemented Interfaces:

Constants

public final class ServiceUtil
extends java.lang.Object
implements Constants

Core utility methods that support Abdera's internal operation

Field Summary

Fields inherited from interface org.apache.abdera.util.Constants

ACCEPT, AID, ALTERNATE, APP_MEDIA_TYPE, APP_NS, APP_NS_PRE_RFC, APP_PREFIX, ATITLE, ATOM_MEDIA_TYPE, ATOM_NS, AURI, AUTHOR, BASE, CAT_MEDIA_TYPE, CATEGORIES, CATEGORY, CLASS, COLLECTION, CONFIG_FACTORY, CONFIG_PARSER, CONFIG_PARSERFACTORY, CONFIG_STREAMWRITER, CONFIG_WRITER, CONFIG_WRITERFACTORY, CONFIG_XPATH, CONTENT, CONTRIBUTOR, CONTROL, CONTROL_NS, CONTROL_PREFIX, DEFAULT_FACTORY, DEFAULT_PARSER, DEFAULT_PARSERFACTORY, DEFAULT_STREAMWRITER, DEFAULT_WRITER, DEFAULT_WRITERFACTORY, DEFAULT_XPATH, DIV, DRAFT, EDITED, EMAIL, ENTRY, ENTRY_MEDIA_TYPE, FEED, FEED_MEDIA_TYPE, FIXED, GENERATOR, HREF, HREFLANG, HTML, ICON, ID, LABEL, LANG, LENGTH, LINK, LN_ACCEPT, LN_ALTERNATE, LN_ALTERNATE_MULTIPART_RELATED, LN_AUTHOR, LN_BASE, LN_CATEGORIES, LN_CATEGORY, LN_CLASS, LN_COLLECTION, LN_CONTENT, LN_CONTRIBUTOR, LN_CONTROL, LN_DIV, LN_DRAFT, LN_EDITED, LN_EMAIL, LN_ENTRY, LN_FEED, LN_FIXED, LN_GENERATOR, LN_HREF, LN_HREFLANG, LN_ICON, LN_ID, LN_LABEL, LN_LANG, LN_LENGTH, LN_LINK, LN_LOGO, LN_NAME, LN_PUBLISHED, LN_REL, LN_RIGHTS, LN_SCHEME, LN_SERVICE, LN_SOURCE, LN_SPACE, LN_SRC, LN_SUBTITLE, LN_SUMMARY, LN_TERM, LN_TITLE, LN_TYPE, LN_UPDATED, LN_URI, LN_VERSION, LN_WORKSPACE, LOGO, MULTIPART_RELATED_TYPE, NAME, NAMED_PARSER, NAMED_WRITER, NO, PRE_RFC_ACCEPT, PRE_RFC_CATEGORIES, PRE_RFC_COLLECTION, PRE_RFC_CONTROL, PRE_RFC_DRAFT, PRE_RFC_EDITED, PRE_RFC_SERVICE, PRE_RFC_WORKSPACE, PREFIX, PREFIXED_TITLE, PUBLISHED, REL, RIGHTS, SCHEME, SERVICE, SOURCE, SPACE, SRC, STREAM_WRITER, SUBTITLE, SUMMARY, TERM, TEXT, TITLE, TYPE, UPDATED, URI, VERSION, WORKSPACE, XHTML, XHTML_NS, XML, XML_MEDIA_TYPE, XML_NS, YES

Method Summary

Modifier and Type	Method and Description
static java.net.URL	getResource(java.lang.String resourceName, java.lang.Class<?> callingClass) Load a given resource.
static java.io.InputStream	getResourceAsStream(java.lang.String resourceName, java.lang.Class<?> callingClass) This is a convenience method to load a resource as a stream.
static java.util.Enumeration<java.net.URL>	getResources(java.lang.String resourceName, java.lang.Class<?> callingClass)
static java.lang.Class<?>	loadClass(java.lang.String className, java.lang.Class<?> callingClass) Load a class with a given name.
static <T> java.util.List<T>	loadimpls(java.lang.String sid)
static <T> java.util.List<T>	loadimpls(java.lang.String sid, boolean classesonly)
static java.lang.Object	locate(java.lang.String id, Abdera abdera) Locate a class instance for the given id
static java.lang.Object	locate(java.lang.String id, java.lang.String _default, Abdera abdera)
static java.lang.Object	locate(java.lang.String id, java.lang.String _default, Abdera abdera, java.lang.Object... args)
static java.lang.Object	locateInstance(java.lang.String id, Abdera abdera)
static java.lang.Object	locateInstance(java.lang.String id, Abdera abdera, boolean classesonly)
static java.lang.Object	locateInstance(java.lang.String id, Abdera abdera, java.lang.Object... args)
static java.util.Enumeration<java.net.URL>	locateResources(java.lang.String id)
static java.io.InputStream	locateStream(java.lang.String id)
static Factory	newFactoryInstance(Abdera abdera) Utility method for returning an instance of the defaul Abdera Factory instance
static java.lang.Object	newInstance(java.lang.String id, java.lang.String _default, Abdera abdera) Returns a new instance of the identified object class.
static java.lang.Object	newInstance(java.lang.String id, java.lang.String _default, Abdera abdera, java.lang.Object... args) Returns a new instance of the identified object class.
static org.apache.abdera.parser.ParserFactory	newParserFactoryInstance(Abdera abdera)
static org.apache.abdera.parser.Parser	newParserInstance(Abdera abdera) Utility method for returning an instance of the default Abdera Parser instance
static StreamWriter	newStreamWriterInstance(Abdera abdera)
static WriterFactory	newWriterFactoryInstance(Abdera abdera)
static Writer	newWriterInstance(Abdera abdera)
static XPath	newXPathInstance(Abdera abdera) Utility method for returning an instance of the default Abdera XPath instance

Methods inherited from class java.lang.Object

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

Method Detail

newInstance

public static java.lang.Object newInstance(java.lang.String id,
                                           java.lang.String _default,
                                           Abdera abdera)

Returns a new instance of the identified object class. This will use the Abdera configuration mechanism to look up the implementation class for the specified id. Several places will be checked: the abdera.properties file, the /META-INF/services directory, and the System properties. If no instance is configured, the default class name will be used. Returns null if no instance can be created.

newInstance

public static java.lang.Object newInstance(java.lang.String id,
                                           java.lang.String _default,
                                           Abdera abdera,
                                           java.lang.Object... args)

Returns a new instance of the identified object class. This will use the Abdera configuration mechanism to look up the implementation class for the specified id. Several places will be checked: the abdera.properties file, the /META-INF/services directory, and the System properties. If no instance is configured, the default class name will be used. Returns null if no instance can be created.

newXPathInstance

public static XPath newXPathInstance(Abdera abdera)

Utility method for returning an instance of the default Abdera XPath instance

newParserInstance

public static org.apache.abdera.parser.Parser newParserInstance(Abdera abdera)

Utility method for returning an instance of the default Abdera Parser instance

newFactoryInstance

public static Factory newFactoryInstance(Abdera abdera)

Utility method for returning an instance of the defaul Abdera Factory instance

newParserFactoryInstance

public static org.apache.abdera.parser.ParserFactory newParserFactoryInstance(Abdera abdera)

newWriterFactoryInstance

public static WriterFactory newWriterFactoryInstance(Abdera abdera)

newWriterInstance

public static Writer newWriterInstance(Abdera abdera)

newStreamWriterInstance

public static StreamWriter newStreamWriterInstance(Abdera abdera)

locate

public static java.lang.Object locate(java.lang.String id,
                                      java.lang.String _default,
                                      Abdera abdera)

locate

public static java.lang.Object locate(java.lang.String id,
                                      java.lang.String _default,
                                      Abdera abdera,
                                      java.lang.Object... args)

locate

public static java.lang.Object locate(java.lang.String id,
                                      Abdera abdera)

Locate a class instance for the given id

locateInstance

public static java.lang.Object locateInstance(java.lang.String id,
                                              Abdera abdera)

locateInstance

public static java.lang.Object locateInstance(java.lang.String id,
                                              Abdera abdera,
                                              boolean classesonly)

locateInstance

public static java.lang.Object locateInstance(java.lang.String id,
                                              Abdera abdera,
                                              java.lang.Object... args)

locateStream

public static java.io.InputStream locateStream(java.lang.String id)

locateResources

public static java.util.Enumeration<java.net.URL> locateResources(java.lang.String id)

loadimpls

public static <T> java.util.List<T> loadimpls(java.lang.String sid)

loadimpls

public static <T> java.util.List<T> loadimpls(java.lang.String sid,
                                              boolean classesonly)

getResource

public static java.net.URL getResource(java.lang.String resourceName,
                                       java.lang.Class<?> callingClass)

Load a given resource.

This method will try to load the resource using the following methods (in order):

• From Thread.currentThread().getContextClassLoader()
• From ClassLoaderUtil.class.getClassLoader()
• callingClass.getClassLoader()

Parameters:

resourceName - The name of the resource to load

callingClass - The Class object of the calling object

getResources

public static java.util.Enumeration<java.net.URL> getResources(java.lang.String resourceName,
                                                               java.lang.Class<?> callingClass)
                                                        throws java.io.IOException

Throws:

java.io.IOException

getResourceAsStream

public static java.io.InputStream getResourceAsStream(java.lang.String resourceName,
                                                      java.lang.Class<?> callingClass)

This is a convenience method to load a resource as a stream.

The algorithm used to find the resource is given in getResource()

Parameters:

resourceName - The name of the resource to load

callingClass - The Class object of the calling object

loadClass

public static java.lang.Class<?> loadClass(java.lang.String className,
                                           java.lang.Class<?> callingClass)
                                    throws java.lang.ClassNotFoundException

Load a class with a given name.

It will try to load the class in the following order:

• From Thread.currentThread().getContextClassLoader()
• Using the basic Class.forName()
• From ClassLoaderUtil.class.getClassLoader()
• From the callingClass.getClassLoader()

Parameters:

className - The name of the class to load

callingClass - The Class object of the calling object

Throws:

java.lang.ClassNotFoundException - If the class cannot be found anywhere.