01: /*
02: * The contents of this file are subject to the terms
03: * of the Common Development and Distribution License
04: * (the "License"). You may not use this file except
05: * in compliance with the License.
06: *
07: * You can obtain a copy of the license at
08: * https://jwsdp.dev.java.net/CDDLv1.0.html
09: * See the License for the specific language governing
10: * permissions and limitations under the License.
11: *
12: * When distributing Covered Code, include this CDDL
13: * HEADER in each file and include the License file at
14: * https://jwsdp.dev.java.net/CDDLv1.0.html If applicable,
15: * add the following below this CDDL HEADER, with the
16: * fields enclosed by brackets "[]" replaced with your
17: * own identifying information: Portions Copyright [yyyy]
18: * [name of copyright owner]
19: */
20: /*
21: * $Id: AuthorityBinding.java,v 1.5 2007/01/08 16:05:56 shyam_rao Exp $
22: */
23:
24: /*
25: * Copyright 2004 Sun Microsystems, Inc. All rights reserved.
26: * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
27: */
28:
29: package com.sun.xml.wss.saml.assertion.saml11.jaxb10;
30:
31: import com.sun.xml.wss.saml.SAMLException;
32:
33: import com.sun.xml.wss.logging.LogDomainConstants;
34: import com.sun.xml.wss.saml.internal.saml11.jaxb10.impl.AuthorityBindingTypeImpl;
35: import com.sun.xml.wss.saml.util.SAMLJAXBUtil;
36: import javax.xml.namespace.QName;
37: import org.w3c.dom.Element;
38: import java.util.logging.Logger;
39:
40: import javax.xml.bind.JAXBContext;
41:
42: /**
43: * The <code>AuthorityBinding</code> element may be used to indicate
44: * to a replying party receiving an <code>AuthenticationStatement</code> that
45: * a SAML authority may be available to provide additional information about
46: * the subject of the statement. A single SAML authority may advertise its
47: * presence over multiple protocol binding, at multiple locations, and as
48: * more than one kind of authority by sending multiple elements as needed.
49: */
50: public class AuthorityBinding
51: extends
52: com.sun.xml.wss.saml.internal.saml11.jaxb10.impl.AuthorityBindingImpl
53: implements com.sun.xml.wss.saml.AuthorityBinding {
54:
55: protected static final Logger log = Logger.getLogger(
56: LogDomainConstants.WSS_API_DOMAIN,
57: LogDomainConstants.WSS_API_DOMAIN_BUNDLE);
58:
59: /**
60: * Constructs an <code>AuthorityBinding</code> element from an existing XML
61: * block.
62: *
63: * @param element representing a DOM tree element.
64: * @exception SAMLException if there is an error in the sender or in the
65: * element definition.
66: */
67: public static AuthorityBindingTypeImpl fromElement(Element element)
68: throws SAMLException {
69: try {
70: JAXBContext jc = SAMLJAXBUtil.getJAXBContext();
71: javax.xml.bind.Unmarshaller u = jc.createUnmarshaller();
72: return (AuthorityBindingTypeImpl) u.unmarshal(element);
73: } catch (Exception ex) {
74: throw new SAMLException(ex.getMessage());
75: }
76: }
77:
78: /**
79: *Constructor
80: *@param authKind A integer representing the type of SAML protocol queries
81: * to which the authority described by this element will
82: * respond. If you do NO specify this attribute, pass in
83: * value "-1".
84: *@param location A URI describing how to locate and communicate with the
85: * authority, the exact syntax of which depends on the
86: * protocol binding in use.
87: *@param binding A String representing a URI reference identifying the SAML
88: * protocol binding to use in communicating with the authority.
89: *@exception SAMLException if there is an error in the sender or in the
90: * element definition.
91: */
92: public AuthorityBinding(QName authKind, String location,
93: String binding) {
94: setAuthorityKind(authKind);
95: setLocation(location);
96: setBinding(binding);
97: }
98: }
|