javax.xml.rpc.handler.HandlerRegistry Maven / Gradle / Ivy
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
package javax.xml.rpc.handler;
import javax.xml.namespace.QName;
import java.io.Serializable;
/**
* The javax.xml.rpc.handler.HandlerRegistry
* provides support for the programmatic configuration of
* handlers in a HandlerRegistry.
*
* A handler chain is registered per service endpoint, as
* indicated by the qualified name of a port. The getHandlerChain
* returns the handler chain (as a java.util.List) for the
* specified service endpoint. The returned handler chain is
* configured using the java.util.List interface. Each element
* in this list is required to be of the Java type
* javax.xml.rpc.handler.HandlerInfo
*
* @version $Rev: 467553 $ $Date: 2006-10-25 00:01:51 -0400 (Wed, 25 Oct 2006) $
*/
public interface HandlerRegistry extends Serializable {
/**
* Gets the handler chain for the specified service endpoint.
* The returned List is used to configure this
* specific handler chain in this HandlerRegistry.
* Each element in this list is required to be of the Java type
* javax.xml.rpc.handler.HandlerInfo.
*
* @param portName Qualified name of the target service
* @return HandlerChain java.util.List Handler chain
* @throws java.lang.IllegalArgumentException If an invalid portName is specified
*/
public java.util.List getHandlerChain(QName portName);
/**
* Sets the handler chain for the specified service endpoint
* as a java.util.List. Each element in this list
* is required to be of the Java type
* javax.xml.rpc.handler.HandlerInfo.
*
* @param portName Qualified name of the target service endpoint
* @param chain a List representing configuration for the
* handler chain
* @throws javax.xml.rpc.JAXRPCException if there is any error in the
* configuration of the handler chain
* @throws java.lang.UnsupportedOperationException if this
* set operation is not supported. This is done to
* avoid any overriding of a pre-configured handler
* chain.
* @throws java.lang.IllegalArgumentException If an invalid
* portName is specified
*/
public abstract void setHandlerChain(QName portName, java.util.List chain);
}