{"type":"doc","content":[{"type":"paragraph","content":[{"text":"shibboleth.Functions.Compose","type":"text","marks":[{"type":"strong"}]},{"text":" constructs a function by composing two other functions together. Mathematically, it takes the arguments \"f\" and \"g\" and an input \"x\" and builds a function that returns ","type":"text"},{"text":"g(f(x))","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Out of necessity the output of \"f\" must be the input type of \"g\".","type":"text"}]},{"type":"paragraph","content":[{"text":"It is an abstract bean so requires two constructor arguments, which are the two aforementioned functions.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that since the resulting bean is itself a function, you can nest composition arbitrarily deep to build chains of function calls.","type":"text"}]},{"type":"paragraph","content":[{"text":"shibboleth.BiFunctions.Compose","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"4.1","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"text":" starts a function composition chain with a ","type":"text"},{"text":"BiFunction","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.util.function.BiFunction"}}]},{"text":". It is a static version of the BiFunction.andThen() method and connects a BiFunction \"f\" returning a type T that is then input to a function \"g\", returning its value. Given inputs \"x\" and \"y\", this represents g(f(x,y)).","type":"text"}]},{"type":"paragraph","content":[{"text":"Because it narrows the inputs to a single value, it can be nested within an arbitrarily deep chain of subsequent function calls.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"Non-contrived examples are difficult, but the most common use is to compose functions together that either navigate the IdP ","type":"text"},{"text":"ProfileRequestContext","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-opensaml.cgi/org.opensaml.profile.context.ProfileRequestContext"}}]},{"text":" tree of objects and/or to return a value from a context object. This allows any data in the tree to be reached declaratively using wired up function beans even when the path to the data is potentially very complex. But note that it doesn't allow the wiring to be ","type":"text"},{"text":"simple,","type":"text","marks":[{"type":"em"}]},{"text":" only possible.","type":"text"}]},{"type":"paragraph","content":[{"text":"Many examples of this approach can be found inside the ","type":"text"},{"text":"system-defined auditing configuration","type":"text","marks":[{"type":"link","attrs":{"href":"https://git.shibboleth.net/view/?p=java-identity-provider.git;a=blob;f=idp-conf-impl/src/main/resources/net/shibboleth/idp/conf/audit-system.xml;h=750afa9d0b632b51a6bce494f718c0ecf225b4d7;hb=HEAD"}}]},{"text":", which uses composed functions to pull audited data out of the request context tree.","type":"text"}]},{"type":"paragraph","content":[{"text":"The following demonstrates combining a function that takes a ","type":"text"},{"text":"ProfileRequestContext","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-opensaml.cgi/org.opensaml.profile.context.ProfileRequestContext"}}]},{"text":" and returns a child context of type ","type":"text"},{"text":"SessionContext","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.session.context.SessionContext"}}]},{"text":" with a function that takes a ","type":"text"},{"text":"SessionContext","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.session.context.SessionContext"}}]},{"text":" and returns the session ID from it.","type":"text"}]},{"type":"paragraph","content":[{"text":"Thus, \"f\" is of type ","type":"text"},{"text":"Function","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.util.function.Function"}}]},{"text":"<","type":"text"},{"text":"ProfileRequestContext","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-opensaml.cgi/org.opensaml.profile.context.ProfileRequestContext"}}]},{"text":", ","type":"text"},{"text":"SessionContext","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.session.context.SessionContext"}}]},{"text":"> and \"g\" is of type ","type":"text"},{"text":"Function","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.util.function.Function"}}]},{"text":"<","type":"text"},{"text":"SessionContext","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.session.context.SessionContext"}}]},{"text":", String>, so composing them produces ","type":"text"},{"text":"Function","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.util.function.Function"}}]},{"text":"<","type":"text"},{"text":"ProfileRequestContext","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-opensaml.cgi/org.opensaml.profile.context.ProfileRequestContext"}}]},{"text":",String> and reuses two primitive building blocks to produce a more complex tool.","type":"text"}]},{"type":"paragraph","content":[{"text":"By convention named arguments are used, but if the names are left out the order of arguments is the outer function and then the inner function.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Function returning Session ID","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\t\n\t\t\n\t\n\t\n\t\t\n\t\n","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported