1 /* 2 * Copyright (c) 1997, 2017, 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 import org.w3c.dom.Element; 43 44 public class Envelope1_2Impl extends EnvelopeImpl { 45 46 protected static final Logger log = 47 Logger.getLogger(Envelope1_2Impl.class.getName(), 48 "com.sun.xml.internal.messaging.saaj.soap.ver1_2.LocalStrings"); 49 50 public Envelope1_2Impl(SOAPDocumentImpl ownerDoc, String prefix) { 51 super(ownerDoc, NameImpl.createEnvelope1_2Name(prefix)); 52 } 53 54 public Envelope1_2Impl(SOAPDocumentImpl ownerDoc, Element domElement) { 55 super(ownerDoc, domElement); 56 } 57 58 public Envelope1_2Impl( 59 SOAPDocumentImpl ownerDoc, 60 String prefix, 61 boolean createHeader, 62 boolean createBody) 63 throws SOAPException { 64 super( 65 ownerDoc, 66 NameImpl.createEnvelope1_2Name(prefix), 67 createHeader, 68 createBody); 69 } 70 71 protected NameImpl getBodyName(String prefix) { 72 return NameImpl.createBody1_2Name(prefix); 73 } 74 75 protected NameImpl getHeaderName(String prefix) { 76 return NameImpl.createHeader1_2Name(prefix); 77 } 78 79 /* 80 * Override setEncodingStyle of ElementImpl to restrict adding encodingStyle 81 * attribute to SOAP Envelope (SOAP 1.2 spec, part 1, section 5.1.1) 82 */ 83 public void setEncodingStyle(String encodingStyle) throws SOAPException { 84 log.severe("SAAJ0404.ver1_2.no.encodingStyle.in.envelope"); 85 throw new SOAPExceptionImpl("encodingStyle attribute cannot appear on Envelope"); 86 } 87 88 /* 89 * Override addAttribute of ElementImpl to restrict adding encodingStyle 90 * attribute to SOAP Envelope (SOAP 1.2 spec, part 1, section 5.1.1) 91 */ 92 public SOAPElement addAttribute(Name name, String value) 93 throws SOAPException { 94 if (name.getLocalName().equals("encodingStyle") 95 && name.getURI().equals(SOAPConstants.URI_NS_SOAP_1_2_ENVELOPE)) { 96 setEncodingStyle(value); 97 } 98 return super.addAttribute(name, value); 99 } 100 101 public SOAPElement addAttribute(QName name, String value) 102 throws SOAPException { 103 if (name.getLocalPart().equals("encodingStyle") 104 && name.getNamespaceURI().equals(SOAPConstants.URI_NS_SOAP_1_2_ENVELOPE)) { 105 setEncodingStyle(value); 106 } 107 return super.addAttribute(name, value); 108 } 109 110 111 /* 112 * Override addChildElement method to ensure that no element 113 * is added after body in SOAP 1.2. 114 */ 115 public SOAPElement addChildElement(Name name) throws SOAPException { 116 // check if body already exists 117 if (getBody() != null) { 118 log.severe("SAAJ0405.ver1_2.body.must.last.in.envelope"); 119 throw new SOAPExceptionImpl( 120 "Body must be the last element in" + " SOAP Envelope"); 121 } 122 return super.addChildElement(name); 123 } 124 125 public SOAPElement addChildElement(QName name) throws SOAPException { 126 // check if body already exists 127 if (getBody() != null) { 128 log.severe("SAAJ0405.ver1_2.body.must.last.in.envelope"); 129 throw new SOAPExceptionImpl( 130 "Body must be the last element in" + " SOAP Envelope"); 131 } 132 return super.addChildElement(name); 133 } 134 135 136 /* 137 * Ideally we should be overriding other addChildElement() methods as well 138 * but we are not adding them here since internally all those call the 139 * method addChildElement(Name name). 140 * In future, if this behaviour changes, then we would need to override 141 * all the rest of them as well. 142 * 143 */ 144 145 public SOAPElement addTextNode(String text) throws SOAPException { 146 log.log( 147 Level.SEVERE, 148 "SAAJ0416.ver1_2.adding.text.not.legal", 149 getElementQName()); 150 throw new SOAPExceptionImpl("Adding text to SOAP 1.2 Envelope is not legal"); 151 } 152 }