org.apache.geronimo.security.util
Class ConfigurationUtil

java.lang.Object
  org.apache.geronimo.security.util.ConfigurationUtil

public class ConfigurationUtil
extends Object

A collection of utility functions that assist with the configuration of PolicyConfigurations.

Version:

$Rev: 826280 $ $Date: 2009-10-18 01:30:50 +0800 (Sun, 18 Oct 2009) $

See Also:

PolicyConfiguration, "JSR 115" Java Authorization Contract for Containers

Constructor Summary

ConfigurationUtil()

Method Summary

static DomainPrincipal	generateDomainPrincipal(String loginDomain, PrincipalInfo principalInfo, org.osgi.framework.Bundle bundle) Create a DomainPrincipal from a deployment description.
static DomainPrincipal	generateDomainPrincipal(String loginDomain, String className, String principalName, org.osgi.framework.Bundle bundle)
static PrimaryDomainPrincipal	generatePrimaryDomainPrincipal(String domain, PrincipalInfo principalInfo, org.osgi.framework.Bundle bundle) Create a DomainPrincipal from a deployment description.
static PrimaryDomainPrincipal	generatePrimaryDomainPrincipal(String domain, String className, String principalName, org.osgi.framework.Bundle bundle)
static PrimaryPrincipal	generatePrimaryPrincipal(PrincipalInfo principalInfo, org.osgi.framework.Bundle bundle) Create a Principal from a deployment description.
static PrimaryPrincipal	generatePrimaryPrincipal(String className, String principalName, org.osgi.framework.Bundle bundle)
static PrimaryRealmPrincipal	generatePrimaryRealmPrincipal(String realm, String domain, PrincipalInfo principalInfo, org.osgi.framework.Bundle bundle) Create a RealmPrincipal from a deployment description.
static PrimaryRealmPrincipal	generatePrimaryRealmPrincipal(String realm, String domain, String className, String principalName, org.osgi.framework.Bundle bundle)
static Principal	generatePrincipal(PrincipalInfo principalInfo, org.osgi.framework.Bundle bundle) Create a Principal from a deployment description.
static Principal	generatePrincipal(String className, String principalName, org.osgi.framework.Bundle bundle)
static RealmPrincipal	generateRealmPrincipal(String realm, String loginDomain, PrincipalInfo principalInfo, org.osgi.framework.Bundle bundle) Create a RealmPrincipal from a deployment description.
static RealmPrincipal	generateRealmPrincipal(String realm, String loginDomain, String className, String principalName, org.osgi.framework.Bundle bundle)
static X500Principal	generateX500Principal(String name) Create an X500Principal from a deployment description.
static void	registerPolicyContextHandler(javax.security.jacc.PolicyContextHandler handler, boolean replace) A simple helper method to register PolicyContextHandlers

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ConfigurationUtil

public ConfigurationUtil()

Method Detail

generateX500Principal

public static X500Principal generateX500Principal(String name)

Create an X500Principal from a deployment description.

Parameters:

name - the distinguished name of the principal

Returns:

an X500Principal from a deployment description

generatePrincipal

public static Principal generatePrincipal(PrincipalInfo principalInfo,
                                          org.osgi.framework.Bundle bundle)

Create a Principal from a deployment description.

Parameters:

principalInfo - the deployment description of the principal to be created.

bundle - Bundle to load principal class

Returns:

a RealmPrincipal from a deployment description

generatePrincipal

public static Principal generatePrincipal(String className,
                                          String principalName,
                                          org.osgi.framework.Bundle bundle)

generateRealmPrincipal

public static RealmPrincipal generateRealmPrincipal(String realm,
                                                    String loginDomain,
                                                    PrincipalInfo principalInfo,
                                                    org.osgi.framework.Bundle bundle)

Create a RealmPrincipal from a deployment description.

Parameters:

principalInfo - the deployment description of the principal to be created.

bundle - Bundle to load principal class

Returns:

a RealmPrincipal from a deployment description

generateRealmPrincipal

public static RealmPrincipal generateRealmPrincipal(String realm,
                                                    String loginDomain,
                                                    String className,
                                                    String principalName,
                                                    org.osgi.framework.Bundle bundle)

generateDomainPrincipal

public static DomainPrincipal generateDomainPrincipal(String loginDomain,
                                                      PrincipalInfo principalInfo,
                                                      org.osgi.framework.Bundle bundle)

Create a DomainPrincipal from a deployment description.

Parameters:

principalInfo - the deployment description of the principal to be created.

bundle - Bundle to load principal class

Returns:

a RealmPrincipal from a deployment description

generateDomainPrincipal

public static DomainPrincipal generateDomainPrincipal(String loginDomain,
                                                      String className,
                                                      String principalName,
                                                      org.osgi.framework.Bundle bundle)

generatePrimaryRealmPrincipal

public static PrimaryRealmPrincipal generatePrimaryRealmPrincipal(String realm,
                                                                  String domain,
                                                                  PrincipalInfo principalInfo,
                                                                  org.osgi.framework.Bundle bundle)
                                                           throws DeploymentException

Create a RealmPrincipal from a deployment description.

Parameters:

principalInfo - the deployment description of the principal to be created.

bundle - Bundle to load principal class

Returns:

a PrimaryRealmPrincipal from a deployment description

Throws:

DeploymentException

generatePrimaryRealmPrincipal

public static PrimaryRealmPrincipal generatePrimaryRealmPrincipal(String realm,
                                                                  String domain,
                                                                  String className,
                                                                  String principalName,
                                                                  org.osgi.framework.Bundle bundle)
                                                           throws DeploymentException

Throws:

DeploymentException

generatePrimaryDomainPrincipal

public static PrimaryDomainPrincipal generatePrimaryDomainPrincipal(String domain,
                                                                    PrincipalInfo principalInfo,
                                                                    org.osgi.framework.Bundle bundle)
                                                             throws DeploymentException

Create a DomainPrincipal from a deployment description.

Parameters:

principalInfo - the deployment description of the principal to be created.

bundle - Bundle to load principal class

Returns:

a PrimaryDomainPrincipal from a deployment description

Throws:

DeploymentException

generatePrimaryDomainPrincipal

public static PrimaryDomainPrincipal generatePrimaryDomainPrincipal(String domain,
                                                                    String className,
                                                                    String principalName,
                                                                    org.osgi.framework.Bundle bundle)
                                                             throws DeploymentException

Throws:

DeploymentException

generatePrimaryPrincipal

public static PrimaryPrincipal generatePrimaryPrincipal(PrincipalInfo principalInfo,
                                                        org.osgi.framework.Bundle bundle)
                                                 throws DeploymentException

Create a Principal from a deployment description.

Parameters:

principalInfo - the deployment description of the principal to be created.

bundle - Bundle to load principal class

Returns:

a Principal from a deployment description

Throws:

DeploymentException

generatePrimaryPrincipal

public static PrimaryPrincipal generatePrimaryPrincipal(String className,
                                                        String principalName,
                                                        org.osgi.framework.Bundle bundle)
                                                 throws DeploymentException

Throws:

DeploymentException

registerPolicyContextHandler

public static void registerPolicyContextHandler(javax.security.jacc.PolicyContextHandler handler,
                                                boolean replace)
                                         throws javax.security.jacc.PolicyContextException

A simple helper method to register PolicyContextHandlers

Parameters:

handler - an object that implements the PolicyContextHandler interface. The value of this parameter must not be null.

replace - this boolean value defines the behavior of this method if, when it is called, a PolicyContextHandler has already been registered to handle the same key. In that case, and if the value of this argument is true, the existing handler is replaced with the argument handler. If the value of this parameter is false the existing registration is preserved and an exception is thrown.

Throws:

javax.security.jacc.PolicyContextException