org.apache.wss4j.stax
Class WSSec

java.lang.Object
  org.apache.wss4j.stax.WSSec

public class WSSec
extends Object

This is the central class of the streaming webservice-security framework.
Instances of the inbound and outbound security streams can be retrieved with this class.

Constructor Summary

WSSec()

Method Summary

static InboundWSSec	getInboundWSSec(WSSSecurityProperties securityProperties) Creates and configures an inbound streaming security engine
static InboundWSSec	getInboundWSSec(WSSSecurityProperties securityProperties, boolean initiator) Creates and configures an inbound streaming security engine
static OutboundWSSec	getOutboundWSSec(WSSSecurityProperties securityProperties) Creates and configures an outbound streaming security engine
static void	init()
static WSSSecurityProperties	validateAndApplyDefaultsToInboundSecurityProperties(WSSSecurityProperties securityProperties) Validates the user supplied configuration and applies default values as apropriate for the inbound security engine
static WSSSecurityProperties	validateAndApplyDefaultsToOutboundSecurityProperties(WSSSecurityProperties securityProperties) Validates the user supplied configuration and applies default values as apropriate for the outbound security engine

Methods inherited from class java.lang.Object

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

Constructor Detail

WSSec

public WSSec()

Method Detail

init

public static void init()

getOutboundWSSec

public static OutboundWSSec getOutboundWSSec(WSSSecurityProperties securityProperties)
                                      throws WSSecurityException

Creates and configures an outbound streaming security engine

Parameters:

securityProperties - The user-defined security configuration

Returns:

A new OutboundWSSec

Throws:

WSSecurityException - if the initialisation failed

WSSConfigurationException - if the configuration is invalid

getInboundWSSec

public static InboundWSSec getInboundWSSec(WSSSecurityProperties securityProperties)
                                    throws WSSecurityException

Creates and configures an inbound streaming security engine

Parameters:

securityProperties - The user-defined security configuration

Returns:

A new InboundWSSec

Throws:

WSSecurityException - if the initialisation failed

WSSConfigurationException - if the configuration is invalid

getInboundWSSec

public static InboundWSSec getInboundWSSec(WSSSecurityProperties securityProperties,
                                           boolean initiator)
                                    throws WSSecurityException

Creates and configures an inbound streaming security engine

Parameters:

securityProperties - The user-defined security configuration

initiator - Whether we are the message initiator or not

Returns:

A new InboundWSSec

Throws:

WSSecurityException - if the initialisation failed

WSSConfigurationException - if the configuration is invalid

validateAndApplyDefaultsToOutboundSecurityProperties

public static WSSSecurityProperties validateAndApplyDefaultsToOutboundSecurityProperties(WSSSecurityProperties securityProperties)
                                                                                  throws WSSConfigurationException

Validates the user supplied configuration and applies default values as apropriate for the outbound security engine

Parameters:

securityProperties - The configuration to validate

Returns:

The validated configuration

Throws:

WSSConfigurationException - if the configuration is invalid

validateAndApplyDefaultsToInboundSecurityProperties

public static WSSSecurityProperties validateAndApplyDefaultsToInboundSecurityProperties(WSSSecurityProperties securityProperties)
                                                                                 throws WSSConfigurationException

Validates the user supplied configuration and applies default values as apropriate for the inbound security engine

Parameters:

securityProperties - The configuration to validate

Returns:

The validated configuration

Throws:

WSSConfigurationException - if the configuration is invalid