...

1. Getting Started

1.1 Using Resources

...

The first thing is to get hold of / create a \[http://jakarta.apache.org/commons/resources/apidocs/org/apache/commons/resources/ResourcesFactory.html ResourcesFactory\] for the *Resources* implementation you want to is a ResourcesFactory for the Resources implementation you want to use...

No Format
ResourcesFactory factory = new PropertyResourcesFactory(); factory.setReturnNull(true);

...

No Format
Object resource = resources.getObject("foo.key", locale, null); String resource = resources.getString("foo.key", locale, null); byte[] resource = resources.getBytes("foo.key", locale, null); Reader resource = resources.getReader("foo.key", locale, null); InputStream resource = resources.getInputStream("foo.key", locale, null);

1.1.1 Return Null Option

Wiki MarkupThe *return null* configuration option indicates what the above five _content retrieval_ methods should do when a resource key is not found - they _either_ return a *{{null}}* value or throw a \[http://jakarta.apache.org/commons/resources/apidocs/org/apache/commons/resources/ ResourcesKeyException.html ResourcesKeyException\].

Use the factory's write method for that property to configure your Resources instances for this option:

...

OK the next question is what Resources implementation do I use? You have two choices...

...

• \[wiki:ResourcesUserGuideImplementations Standard Implementations\] - Commons Resources comes with a set of standard implementations for *properties* files, *XML* documents, *database* resources and versions for use in a *Web Application*
• Wiki Markup\[wiki:ResourcesUserGuideCreating Creating an Implementation\] - create your own implementation. \\
  

1.2 Messages

The majority of what Commons Resources is about centers around the Resources type. However there are also two types defined for handling messages:

• Wiki Markup\[http://jakarta.apache.org/commons/resources/apidocs/org/apache/commons/resources/Message.html Message\] - a message representation. Wiki Markup\[http://jakarta.apache.org/commons/resources/apidocs/org/apache/commons/resources/MessageList.html
• MessageList\] - a set of Message objects. \\
  

There is also a convenience class, provding static methods to facilitate handling messages:

• Wiki Markup
  \[http://jakarta.apache.org/commons/resources/apidocs/org/apache/commons/resources/Messages.html Messages\] - convenience class for handling messages. \\ \\

See the \[wiki:ResourcesUserGuideMessages Messages\] section in this User Guide for more details.

wrapper class, that provides message string lookups from a Resources instance, and parameter replacement:

• Messages - convenience class for handling messages.
  
  

See the Messages section in this User Guide for more details.

...