This repository provides an extension of net.yetamine.sova library for Java Servlet API. Define attributes of your requests and context parameters in a type-safe way!
Let's take a classical example with X.509 certificates from a request:
// Define such a constant for the attributes that you want to access
public static final ServletRequestSymbol<X509Certificate[]> CERTIFICATES
= new ServletRequestSymbol<>("javax.servlet.request.X509Certificate", Downcasting.to(X509Certificate[].class));
// Use the constant defining the key to get the request attribute
final X509Certificate[] certs = CERTIFICATES.get(servletRequest);
// This is an effective replacement for:
// final X509Certificate[] certs = (X509Certificate[]) servletRequest.getAttribute("javax.servlet.request.X509Certificate");
The example shows how using the typed key relieves the user from casting and remembering the exact attribute name, or when defining a constant fo the name, allows coupling the name with the type right away, with proper documentation of the entry that the name refers to.
For building this project is needed:
- JDK 8 or newer.
- Maven 3.3 or newer.
For using the built library is needed:
- JRE 8 or newer.
A special thank belongs to Atos. The development of this library would be much slower without their support which provided a great opportunity to verify the library practically and improve it according to the experience.
Another thank belongs to davej from project77.org for the permission to use his owl picture as the logo for this project. Why an owl? Because it is so cute and because sova means an owl in Czech.
The project is licensed under the Apache 2.0 license. Contributions to the project are welcome and accepted if they can be incorporated without the need of changing the license or license conditions and terms.
