5.1.0.20 (Sept 5, 2015)

Juno 5.1.0.20 is a moderate update. The biggest improvement is the ability to associate external INI config files with REST servlets using the ConfigFile functionality.

##### Core

- Significant API changes to org.apache.juneau.config API.
  - ConfigFile is now thread safe and can be shared across multiple threads.
  - New ConfigMgr class for managing configuration files.
  - Serializers and parsers can be associated with config files for storing and retrieving POJOs. Default support provided for JSON.
- New {@link oaj.html.SimpleHtmlWriter} class. Can be used for simple HTML DOM construction.
- New {@link oaj.utils.ProcBuilder} class for calling external processes.
- New ObjectMap.remove(Class,String,Object) method.
- "class='link'" added to links generated by {@link oaj.html.HtmlDocSerializer}.
- New EncoderGroup#append(EncoderGroup) method.
- New HtmlDocSerializerContext.HTMLDOC_addLinks configuration property.
- Modified the Parser.createContext(ObjectMap,Method,Object) method. Outer context objects can be passed in to create instances of non-static inner classes.
- Fixed bug in {@link oaj.html.HtmlStrippedDocSerializer} where exception was thrown when trying to serialize primitive arrays.
- {@link oaj.json.JsonParser} now handles parsing JSON boolean/numeric values as strings to bean properties of type boolean or number.
- {@link oaj.urlencoding.UrlEncodingSerializer} and {@link oaj.urlencoding.UrlEncodingParser} now represent arrays and collections as key-value pairs where the keys are numbers (e.g. "?0=foo&1=bar").
- Various internal improvements to {@link oaj.utils.IOPipe}.
- New ReflectionUtils.getResource(Class,String) method.
- {@link oaj.internal.StringUtils#parseNumber(String,Class)} now returns zero for empty strings. This affects the way most parsers handle blank values.

##### Server

- You can now parse into non-static inner classes of a servlet for parameters/attributes/content. Useful if you like to define your marshaller beans inside your servlet.
- Changes to {@link oajr.RestServlet}:
  - New methods for accessing external INI config files:
    RestServlet.getConfig()
    RestServlet.createConfigFile()
  - New "$C{...}" variable that resolve to INI config file values.
  - New "$UE{...}" variable that URL-encodes the value inside the variable.
  - New convenience methods for retrieving classpath resource files:
    RestServlet.getResource(String)
    RestServlet.getResourceAsString(String)
    RestServlet.getResource(Class,String,String). Useful if you want to load predefined POJOs from JSON files in your classpath.
  - New RestServlet.handleNotFound(int,RestRequest,RestResponse) method for customized handling of when a resource or method was not found.
- {@link oajr.BasicRestServlet} now automatically processes "/favicon.ico" requests by overriding the new RestServlet.handleNotFound(int,RestRequest,RestResponse) method.
- New {@link oajr.RestRequest} methods:
  - RestRequest.resolveVars(String)
  - RestRequest.getVarResource(String)
  - RestRequest.getConfig()
- New {@link oajr.RestResponse} methods:
  - {@link oajr.RestResponse#getDirectWriter(String)}.
  - {@link oajr.RestResponse#getNegotiatedWriter()}. getWriter() now returns an unnegotiated writer. getUnbufferedWriter() has been removed.
- New {@link oajr.annotation.RestMethod#encoders() @RestMethod(encoders)} and RestMethod.inheritEncoders() annotations. Allows encoders to be fine-tuned at the method level.
- New {@link oajr.annotation.RestResource#config() @RestResource(config)} annotation for associating external ConfigFile config files with servlets.
- ResourceLink.
- New org.apache.juneau.rest.matchers package for commonly-used {@link oajr.RestMatcher RestMatchers}:
  - {@link oajr.matchers#MultipartFormDataMatcher}
  - {@link oajr.matchers#UrlEncodedFormMatcher}

##### Microservice

- New juneau-microservice.jar file that encapsulates all 3 juneau jars with code necessary for creating fast and efficent jetty-powered REST microservices.
  Contains the following:
  - Jetty 8.0
  - Apache HttpClient 4.3.5
  - Apache Commons FileUpload 1.3.1
- Microservice now supports Java 6 (previously required Java 7)