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:06:07 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.jaxb20;
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.jaxb20.AuthorityBindingType;
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 extends AuthorityBindingType implements
51: com.sun.xml.wss.saml.AuthorityBinding {
52:
53: protected static final Logger log = Logger.getLogger(
54: LogDomainConstants.WSS_API_DOMAIN,
55: LogDomainConstants.WSS_API_DOMAIN_BUNDLE);
56:
57: /**
58: * Constructs an <code>AuthorityBinding</code> element from an existing XML
59: * block.
60: *
61: * @param element representing a DOM tree element.
62: * @exception SAMLException if there is an error in the sender or in the
63: * element definition.
64: */
65: public static AuthorityBindingType fromElement(Element element)
66: throws SAMLException {
67: try {
68: JAXBContext jc = SAMLJAXBUtil.getJAXBContext();
69:
70: javax.xml.bind.Unmarshaller u = jc.createUnmarshaller();
71: return (AuthorityBindingType) u.unmarshal(element);
72: } catch (Exception ex) {
73: throw new SAMLException(ex.getMessage());
74: }
75: }
76:
77: /**
78: *Constructor
79: *@param authKind A integer representing the type of SAML protocol queries
80: * to which the authority described by this element will
81: * respond. If you do NO specify this attribute, pass in
82: * value "-1".
83: *@param location A URI describing how to locate and communicate with the
84: * authority, the exact syntax of which depends on the
85: * protocol binding in use.
86: *@param binding A String representing a URI reference identifying the SAML
87: * protocol binding to use in communicating with the authority.
88: *@exception SAMLException if there is an error in the sender or in the
89: * element definition.
90: */
91: public AuthorityBinding(QName authKind, String location,
92: String binding) {
93: setAuthorityKind(authKind);
94: setLocation(location);
95: setBinding(binding);
96: }
97: }
|