WildFly and JBoss Modules - PicketLink - Project Documentation Editor for your Wiki!
This page will describe how the PicketLink libraries are organized in WildFly.
Before you start, you must know that WildFly is heavily based on JBoss Modules, which provides a modular class loading and execution environment. It allows you to centralize all the necessary dependencies and their configuration in a single place, making a lot more easier to manage your dependencies versions and deploy your applications.
The PicketLink libraries are shipped in WildFly since version 8.0.0.Final. So you don't need to ship any PicketLink library inside your deployment to get it running and using all features provided by PicketLink.
It is also important that you're familiar with WildFly Class Loading.
Each directory above is related with a specific PicketLink library. For example, core, federation and idm are related with PicketLink JEE Security, Federation and IDM, respectively. Inside each directory there is a main directory, where is located all JAR files. You will also notice a XML file called module.xml inside each directory, which is used to configure the module's resources and dependencies.
If you have ever used PicketLink in JBoss Application Server 7 or EAP, you'll notice that we still have the org.picketlink module (which maps to the org/picketlink/main directory). This module is there for backward compatibility, specially for those using PicketLink Federation. If you look at the module.xml you'll notice that there is no JAR reference, but a bunch of dependencies instead. The PicketLink Federation JARs are located at org.picketlink.federation and org.picketlink.federation.bindings modules.
The PicketLink Federation modules are NOT properly updated and configured in WildFly 8.0.0.Final. If you want to use it, you'll need to wait for WildFly 8.0.1+ versions.
The following table describes all modules and theirs corresponding JAR files.
In the example above, we're configuring the org.picketlink module as a dependency. As you can see, this is exactly the same configuration as you did before when using PicketLink Federation in JBoss AS7 or EAP.
The version used by the modules is not always the latest version of PicketLink. The good news is that you can always update the PicketLink modules with the latest version by only replacing the JAR files for each module.
First of all, get the latest JAR version for the module you want to update. Check the table above for more details about each module and their corresponding JAR files.