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: NameIdentifier.java,v 1.5 2007/01/08 16:06:06 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.NameIdentifierType;
35: import com.sun.xml.wss.saml.util.SAMLJAXBUtil;
36: import java.util.logging.Logger;
37:
38: import javax.xml.bind.JAXBContext;
39:
40: /**
41: *The NameIdentifier element specifies a <code>Subject</code> by a combination
42: * of a name and a security domain governing the name of the <code>Subject</code>.
43: */
44: public class NameIdentifier extends NameIdentifierType implements
45: com.sun.xml.wss.saml.NameIdentifier {
46:
47: protected static final Logger log = Logger.getLogger(
48: LogDomainConstants.WSS_API_DOMAIN,
49: LogDomainConstants.WSS_API_DOMAIN_BUNDLE);
50:
51: /**
52: * Constructs a <code>NameIdentifer</code> element from an existing XML
53: * block.
54: *
55: * @param nameIdentifierElement A <code>org.w3c.dom.Element</code>
56: * representing DOM tree for <code>NameIdentifier</code> object
57: * @exception SAMLException if it could not process the
58: * <code>org.w3c.dom.Element</code> properly, implying that there
59: * is an error in the sender or in the element definition.
60: */
61: public static NameIdentifierType fromElement(
62: org.w3c.dom.Element element) throws SAMLException {
63: try {
64: JAXBContext jc = SAMLJAXBUtil.getJAXBContext();
65:
66: javax.xml.bind.Unmarshaller u = jc.createUnmarshaller();
67: return (NameIdentifierType) u.unmarshal(element);
68: } catch (Exception ex) {
69: throw new SAMLException(ex.getMessage());
70: }
71: }
72:
73: /**
74: * Constructs a <code>NameQualifier</code> instance.
75: *
76: * @param name The string representing the name of the Subject
77: * @param nameQualifier The security or administrative domain that qualifies
78: * the name of the <code>Subject</code>. This is optional could be
79: * null or "".
80: * @param format The syntax used to describe the name of the
81: * <code>Subject</code>. This optional, could be null or "".
82: * @exception SAMLException if the input has an error.
83: */
84: public NameIdentifier(String name, String nameQualifier,
85: String format) {
86: if (name != null)
87: setValue(name);
88:
89: if (nameQualifier != null)
90: setNameQualifier(nameQualifier);
91:
92: if (format != null)
93: setFormat(format);
94: }
95: }
|