01: /*
02: * Licensed to the Apache Software Foundation (ASF) under one
03: * or more contributor license agreements. See the NOTICE file
04: * distributed with this work for additional information
05: * regarding copyright ownership. The ASF licenses this file
06: * to you under the Apache License, Version 2.0 (the
07: * "License"); you may not use this file except in compliance
08: * with the License. You may obtain a copy of the License at
09: *
10: * http://www.apache.org/licenses/LICENSE-2.0
11: *
12: * Unless required by applicable law or agreed to in writing,
13: * software distributed under the License is distributed on an
14: * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15: * KIND, either express or implied. See the License for the
16: * specific language governing permissions and limitations
17: * under the License.
18: */
19: package org.apache.axis2.jaxws.runtime.description.marshal;
20:
21: /**
22: * Description of FaultBean for a FaultDescription. The FaultBean is used to marshal and unmarshal
23: * the exception. The FaultBean is determined via annotation, faultInfo and package introspection.
24: */
25: public interface FaultBeanDesc {
26:
27: /**
28: * Get the class name of the fault bean for the FaultDescription. Note that the FaultBean may
29: * not be a bean. It can be a non-bean (i.e. String or int)
30: * <p/>
31: * Algorithm: 1) The class defined on @WebFault of the exception 2) If not present or invalid,
32: * the class defined by getFaultInfo. 3) If not present, the class is found by looking for the a
33: * class named <exceptionName>Bean in the interface's package. 4) If not present, the class is
34: * found by looking for the a class named <exceptionName>Bean in the interface + jaxws package
35: *
36: * @return
37: */
38: public String getFaultBeanClassName();
39:
40: /**
41: * Get the local name of the fault bean. Algorithm: 1) The name defined on the @WebFault of the
42: * exception. 2) If not present, the name defined via the @XmlRootElement of the fault bean
43: * class. 3) If not present, the <exceptionName>Bean
44: *
45: * @return local name
46: */
47: public String getFaultBeanLocalName();
48:
49: /**
50: * Get the targetNamespace of the fault bean. Algorithm: 1) The namespace defined on the
51: * @WebFault of the exception. 2) If not present, the namespace defined via the @XmlRootElement
52: * of the class name. 3) If not present, the namespace of the method's declared class +
53: * "/jaxws"
54: *
55: * @return local name
56: */
57: public String getFaultBeanNamespace();
58:
59: }
|