1 /* 2 * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. Oracle designates this 8 * particular file as subject to the "Classpath" exception as provided 9 * by Oracle in the LICENSE file that accompanied this code. 10 * 11 * This code is distributed in the hope that it will be useful, but WITHOUT 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 * version 2 for more details (a copy is included in the LICENSE file that 15 * accompanied this code). 16 * 17 * You should have received a copy of the GNU General Public License version 18 * 2 along with this work; if not, write to the Free Software Foundation, 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 /** 27 * 28 * @author SAAJ RI Development Team 29 */ 30 package com.sun.xml.internal.messaging.saaj.soap.ver1_2; 31 32 import java.util.logging.Logger; 33 import java.util.logging.Level; 34 35 import javax.xml.namespace.QName; 36 import javax.xml.soap.*; 37 38 import com.sun.xml.internal.messaging.saaj.SOAPExceptionImpl; 39 import com.sun.xml.internal.messaging.saaj.soap.SOAPDocumentImpl; 40 import com.sun.xml.internal.messaging.saaj.soap.impl.EnvelopeImpl; 41 import com.sun.xml.internal.messaging.saaj.soap.name.NameImpl; 42 43 public class Envelope1_2Impl extends EnvelopeImpl { 44 45 protected static final Logger log = 46 Logger.getLogger(Envelope1_2Impl.class.getName(), 47 "com.sun.xml.internal.messaging.saaj.soap.ver1_2.LocalStrings"); 48 49 public Envelope1_2Impl(SOAPDocumentImpl ownerDoc, String prefix) { 50 super(ownerDoc, NameImpl.createEnvelope1_2Name(prefix)); 51 } 52 53 public Envelope1_2Impl( 54 SOAPDocumentImpl ownerDoc, 55 String prefix, 56 boolean createHeader, 57 boolean createBody) 58 throws SOAPException { 59 super( 60 ownerDoc, 61 NameImpl.createEnvelope1_2Name(prefix), 62 createHeader, 63 createBody); 64 } 65 66 protected NameImpl getBodyName(String prefix) { 67 return NameImpl.createBody1_2Name(prefix); 68 } 69 70 protected NameImpl getHeaderName(String prefix) { 71 return NameImpl.createHeader1_2Name(prefix); 72 } 73 74 /* 75 * Override setEncodingStyle of ElementImpl to restrict adding encodingStyle 76 * attribute to SOAP Envelope (SOAP 1.2 spec, part 1, section 5.1.1) 77 */ 78 public void setEncodingStyle(String encodingStyle) throws SOAPException { 79 log.severe("SAAJ0404.ver1_2.no.encodingStyle.in.envelope"); 80 throw new SOAPExceptionImpl("encodingStyle attribute cannot appear on Envelope"); 81 } 82 83 /* 84 * Override addAttribute of ElementImpl to restrict adding encodingStyle 85 * attribute to SOAP Envelope (SOAP 1.2 spec, part 1, section 5.1.1) 86 */ 87 public SOAPElement addAttribute(Name name, String value) 88 throws SOAPException { 89 if (name.getLocalName().equals("encodingStyle") 90 && name.getURI().equals(SOAPConstants.URI_NS_SOAP_1_2_ENVELOPE)) { 91 setEncodingStyle(value); 92 } 93 return super.addAttribute(name, value); 94 } 95 96 public SOAPElement addAttribute(QName name, String value) 97 throws SOAPException { 98 if (name.getLocalPart().equals("encodingStyle") 99 && name.getNamespaceURI().equals(SOAPConstants.URI_NS_SOAP_1_2_ENVELOPE)) { 100 setEncodingStyle(value); 101 } 102 return super.addAttribute(name, value); 103 } 104 105 106 /* 107 * Override addChildElement method to ensure that no element 108 * is added after body in SOAP 1.2. 109 */ 110 public SOAPElement addChildElement(Name name) throws SOAPException { 111 // check if body already exists 112 if (getBody() != null) { 113 log.severe("SAAJ0405.ver1_2.body.must.last.in.envelope"); 114 throw new SOAPExceptionImpl( 115 "Body must be the last element in" + " SOAP Envelope"); 116 } 117 return super.addChildElement(name); 118 } 119 120 public SOAPElement addChildElement(QName name) throws SOAPException { 121 // check if body already exists 122 if (getBody() != null) { 123 log.severe("SAAJ0405.ver1_2.body.must.last.in.envelope"); 124 throw new SOAPExceptionImpl( 125 "Body must be the last element in" + " SOAP Envelope"); 126 } 127 return super.addChildElement(name); 128 } 129 130 131 /* 132 * Ideally we should be overriding other addChildElement() methods as well 133 * but we are not adding them here since internally all those call the 134 * method addChildElement(Name name). 135 * In future, if this behaviour changes, then we would need to override 136 * all the rest of them as well. 137 * 138 */ 139 140 public SOAPElement addTextNode(String text) throws SOAPException { 141 log.log( 142 Level.SEVERE, 143 "SAAJ0416.ver1_2.adding.text.not.legal", 144 getElementQName()); 145 throw new SOAPExceptionImpl("Adding text to SOAP 1.2 Envelope is not legal"); 146 } 147 }