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 }