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: */package org.apache.cxf.ws.policy;
19:
20: import javax.xml.namespace.QName;
21:
22: import org.w3c.dom.Element;
23:
24: import org.apache.cxf.extension.Registry;
25: import org.apache.neethi.Assertion;
26:
27: /**
28: * AssertionBuilderRegistry is used to manage AssertionBuilders and
29: * create Assertion objects from given xml elements.
30: */
31: public interface AssertionBuilderRegistry extends
32: Registry<QName, AssertionBuilder> {
33:
34: /**
35: * Returns an assertion that is built using the specified xml element.
36: *
37: * @param element the element from which to build an Assertion.
38: * @return an Assertion that is built using the specified element.
39: */
40: Assertion build(Element element);
41:
42: /**
43: * Indicates if unknown assertions should simply be ignored.
44: * If set to false, the policy engine will throw an exception upon
45: * encountering an assertion type for which no AssertionBuilder
46: * has been registered.
47: * @return
48: */
49: boolean isIgnoreUnknownAssertions();
50:
51: /**
52: * Indicates if unknown assertions should simply be ignored.
53: * If set to false, the policy engine will throw an exception upon
54: * encountering an assertion type for which no AssertionBuilder
55: * has been registered.
56: * @param ignoreUnknownAssertions iff unknown assertions should be ignored
57: */
58: void setIgnoreUnknownAssertions(boolean ignoreUnknownAssertions);
59: }
|