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 }