com.sun.xml.ws.api.security
Class CallbackHandlerFeature

java.lang.Object
  extended by javax.xml.ws.WebServiceFeature
      extended by com.sun.xml.ws.api.security.CallbackHandlerFeature

public final class CallbackHandlerFeature
extends javax.xml.ws.WebServiceFeature

WebServiceFeature that controls CallbackHandler used during security related processing of Metro.

This rather untyped, low-level and user-unfriendly CallbackHandler object controls many details of the security processing at runtime, such as locating CertStore or KeyStore. While we'd like to provide a higher level features for common configurations, this feature works as an catch-all escape hatch.

See DefaultCallbackHandler.handle(Callback[]) implementation as an example of what callback CallbackHandler receives (note that this default implementation class itself is not a committed part of Metro.)

This feature allows you to pass in an instance of CallbackHandler unlike <sc:CallbackHandlerConfiguration> assertion, which makes it convenient to pass in some state from the calling application into CallbackHandler.

Since:
Metro 1.5

Field Summary
 
Fields inherited from class javax.xml.ws.WebServiceFeature
enabled
 
Constructor Summary
CallbackHandlerFeature(javax.security.auth.callback.CallbackHandler handler)
           
 
Method Summary
 javax.security.auth.callback.CallbackHandler getHandler()
           
 java.lang.String getID()
           
 
Methods inherited from class javax.xml.ws.WebServiceFeature
isEnabled
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

CallbackHandlerFeature

public CallbackHandlerFeature(@NotNull
                              javax.security.auth.callback.CallbackHandler handler)
Method Detail

getID

public java.lang.String getID()
Specified by:
getID in class javax.xml.ws.WebServiceFeature

getHandler

@NotNull
public javax.security.auth.callback.CallbackHandler getHandler()
Returns:
CallbackHandler set in the constructor. Never null.