{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Prior to V5, the ","type":"text"},{"text":"HttpServletRequest","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.oracle.com/javaee/7/api/javax/servlet/http/HttpServletRequest.html"}}]},{"text":" and ","type":"text"},{"text":"HttpServletResponse","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.oracle.com/javaee/7/api/javax/servlet/http/HttpServletResponse.html"}}]},{"text":" objects for the current request were made available via two beans named ","type":"text"},{"text":"shibboleth.HttpServletResponse","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"shibboleth.HttpServletResponse","type":"text","marks":[{"type":"strong"}]},{"text":". In V4.3 these were deprecated, and in V5 they have been removed. This was necessary to avoid requiring us to actually implement the servlet interfaces, which is difficult to do when mutliple versions of the Servlet API are potentially supported by the surrounding libraries and container.","type":"text"}]},{"type":"paragraph","content":[{"text":"These objects are now accessed via ","type":"text"},{"text":"Supplier","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.util.function.Supplier"}}]},{"text":" beans named ","type":"text"},{"text":"shibboleth.HttpServletResponseSupplier","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"shibboleth.HttpServletResponseSupplier","type":"text","marks":[{"type":"strong"}]},{"text":". The changed names reflect the fact that scripts and other code making use of these beans has to be modified to insert a call to the Supplier.get() method to access the actual interfaces.","type":"text"}]},{"type":"paragraph","content":[{"text":"In V5, all use of the old beans must be replaced by use of the new beans. This is a formulaic change.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Spring Wiring","type":"text"}]},{"type":"paragraph","content":[{"text":"All objects which took a ","type":"text"},{"text":"p:httpServletRequest","type":"text","marks":[{"type":"code"}]},{"text":" property now take a ","type":"text"},{"text":"p:httpServletRequestSupplier","type":"text","marks":[{"type":"code"}]},{"text":" property hence","type":"text"}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"becomes","type":"text"}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Scripting, Velocity","type":"text"}]},{"type":"paragraph","content":[{"text":"If the script previously passed ","type":"text"},{"text":"shibboleth.HttpServletRequest","type":"text","marks":[{"type":"code"}]},{"text":" as the ","type":"text"},{"text":"custom","type":"text","marks":[{"type":"code"}]},{"text":" parameter it should now have ","type":"text"},{"text":"shibboleth.HttpServletRequestSupplier","type":"text","marks":[{"type":"code"}]},{"text":" passed instead.","type":"text"}]},{"type":"paragraph","content":[{"text":"Inside the script the change consists of adding a call to get() in between the original reference to the bean and the servlet method called.","type":"text"}]},{"type":"paragraph","content":[{"text":"Hence the (contrived) example","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"becomes","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n \n \n \n \n","type":"text"}]},{"type":"paragraph"}],"version":1}