org.glassfish.web.deployment.node.ServletNode Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of payara-micro Show documentation
Show all versions of payara-micro Show documentation
Micro Distribution of the Payara Project
/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright (c) 1997-2012 Oracle and/or its affiliates. All rights reserved.
*
* The contents of this file are subject to the terms of either the GNU
* General Public License Version 2 only ("GPL") or the Common Development
* and Distribution License("CDDL") (collectively, the "License"). You
* may not use this file except in compliance with the License. You can
* obtain a copy of the License at
* https://glassfish.dev.java.net/public/CDDL+GPL_1_1.html
* or packager/legal/LICENSE.txt. See the License for the specific
* language governing permissions and limitations under the License.
*
* When distributing the software, include this License Header Notice in each
* file and include the License file at packager/legal/LICENSE.txt.
*
* GPL Classpath Exception:
* Oracle designates this particular file as subject to the "Classpath"
* exception as provided by Oracle in the GPL Version 2 section of the License
* file that accompanied this code.
*
* Modifications:
* If applicable, add the following below the License Header, with the fields
* enclosed by brackets [] replaced by your own identifying information:
* "Portions Copyright [year] [name of copyright owner]"
*
* Contributor(s):
* If you wish your version of this file to be governed by only the CDDL or
* only the GPL Version 2, indicate your decision by adding "[Contributor]
* elects to include this software in this distribution under the [CDDL or GPL
* Version 2] license." If you don't indicate a single choice of license, a
* recipient has the option to distribute your version of this file under
* either the CDDL, the GPL Version 2 or to extend the choice of license to
* its licensees as provided above. However, if you add GPL Version 2 code
* and therefore, elected the GPL Version 2 license, then the option applies
* only if the new code is made subject to such option by the copyright
* holder.
*/
package org.glassfish.web.deployment.node;
import com.sun.enterprise.deployment.RoleReference;
import com.sun.enterprise.deployment.RunAsIdentityDescriptor;
import com.sun.enterprise.deployment.WebComponentDescriptor;
import com.sun.enterprise.deployment.node.*;
import com.sun.enterprise.deployment.util.DOLUtils;
import com.sun.enterprise.deployment.web.EnvironmentEntry;
import com.sun.enterprise.deployment.web.InitializationParameter;
import com.sun.enterprise.deployment.web.MultipartConfig;
import org.glassfish.web.deployment.descriptor.MultipartConfigDescriptor;
import org.glassfish.web.deployment.descriptor.WebComponentDescriptorImpl;
import org.glassfish.web.deployment.xml.WebTagNames;
import org.w3c.dom.Node;
import java.util.Enumeration;
import java.util.Map;
import java.util.logging.Level;
/**
* This node is responsible for handling the servlet xml sub tree
*
* @author Jerome Dochez
* @version
*/
public class ServletNode extends DisplayableComponentNode {
private final static XMLElement tag =
new XMLElement(WebTagNames.SERVLET);
private WebComponentDescriptor descriptor;
/** Creates new ServletNode */
public ServletNode() {
super();
registerElementHandler(new XMLElement(WebTagNames.ROLE_REFERENCE), SecurityRoleRefNode.class);
registerElementHandler(new XMLElement(WebTagNames.INIT_PARAM), InitParamNode.class);
registerElementHandler(new XMLElement(WebTagNames.RUNAS_SPECIFIED_IDENTITY),
RunAsNode.class, "setRunAsIdentity");
registerElementHandler(new XMLElement(WebTagNames.MULTIPART_CONFIG), MultipartConfigNode.class);
}
/**
* @return the XML tag associated with this XMLNode
*/
@Override
protected XMLElement getXMLRootTag() {
return tag;
}
/**
* @return the descriptor instance to associate with this XMLNode
*/
@Override
public WebComponentDescriptor getDescriptor() {
if (descriptor==null) {
descriptor = new WebComponentDescriptorImpl();
}
return descriptor;
}
/**
* Adds a new DOL descriptor instance to the descriptor instance associated with
* this XMLNode
*
* @param newDescriptor the new descriptor
*/
@Override
public void addDescriptor(Object newDescriptor) {
if (newDescriptor instanceof RoleReference) {
if (DOLUtils.getDefaultLogger().isLoggable(Level.FINE)) {
DOLUtils.getDefaultLogger().fine("Adding security role ref " + newDescriptor);
}
descriptor.addSecurityRoleReference(
(RoleReference) newDescriptor);
} else if (newDescriptor instanceof EnvironmentEntry) {
if (DOLUtils.getDefaultLogger().isLoggable(Level.FINE)) {
DOLUtils.getDefaultLogger().fine("Adding init-param " + newDescriptor);
}
descriptor.addInitializationParameter(
(InitializationParameter) newDescriptor);
} else if (newDescriptor instanceof MultipartConfig) {
descriptor.setMultipartConfig((MultipartConfig)newDescriptor);
} else super.addDescriptor(newDescriptor);
}
/**
* all sub-implementation of this class can use a dispatch table to map xml element to
* method name on the descriptor class for setting the element value.
*
* @return the map with the element name as a key, the setter method as a value
*/
@Override
protected Map getDispatchTable() {
// no need to be synchronized for now
Map table = super.getDispatchTable();
table.put(WebTagNames.NAME, "setName");
table.put(WebTagNames.SERVLET_NAME, "setCanonicalName");
return table;
}
/**
* receives notiification of the value for a particular tag
*
* @param element the xml element
* @param value it's associated value
*/
@Override
public void setElementValue(XMLElement element, String value) {
if (WebTagNames.SERVLET_CLASS.equals(element.getQName())) {
descriptor.setServlet(true);
descriptor.setWebComponentImplementation(value);
} else if (WebTagNames.JSP_FILENAME.equals(element.getQName())) {
descriptor.setServlet(false);
descriptor.setWebComponentImplementation(value);
} else if (WebTagNames.LOAD_ON_STARTUP.equals(element.getQName())) {
if (value.trim().equals("")) {
descriptor.setLoadOnStartUp(Integer.MAX_VALUE);
} else {
descriptor.setLoadOnStartUp(Integer.valueOf(value));
}
} else if (WebTagNames.ENABLED.equals(element.getQName())) {
descriptor.setEnabled(Boolean.parseBoolean(value));
} else if (WebTagNames.ASYNC_SUPPORTED.equals(element.getQName())) {
descriptor.setAsyncSupported(Boolean.valueOf(value));
} else {
super.setElementValue(element, value);
}
}
/**
* write the descriptor class to a DOM tree and return it
*
* @param parent node in the DOM tree
* @param descriptor the descriptor to write
* @return the DOM tree top node
*/
@Override
public Node writeDescriptor(Node parent, WebComponentDescriptor descriptor) {
Node myNode = super.writeDescriptor(parent, descriptor);
appendTextChild(myNode, WebTagNames.SERVLET_NAME, descriptor.getCanonicalName());
if (descriptor.isServlet()) {
appendTextChild(myNode, WebTagNames.SERVLET_CLASS, descriptor.getWebComponentImplementation());
} else {
appendTextChild(myNode, WebTagNames.JSP_FILENAME, descriptor.getWebComponentImplementation());
}
// init-param*
WebCommonNode.addInitParam(myNode, WebTagNames.INIT_PARAM, descriptor.getInitializationParameters());
if (descriptor.getLoadOnStartUp()!=null) {
appendTextChild(myNode, WebTagNames.LOAD_ON_STARTUP, String.valueOf(descriptor.getLoadOnStartUp()));
}
appendTextChild(myNode, WebTagNames.ENABLED, String.valueOf(descriptor.isEnabled()));
if (descriptor.isAsyncSupported() != null) {
appendTextChild(myNode, WebTagNames.ASYNC_SUPPORTED, String.valueOf(descriptor.isAsyncSupported()));
}
// run-as
RunAsIdentityDescriptor runAs = descriptor.getRunAsIdentity();
if (runAs!=null) {
RunAsNode runAsNode = new RunAsNode();
runAsNode.writeDescriptor(myNode, WebTagNames.RUNAS_SPECIFIED_IDENTITY, runAs);
}
// sercurity-role-ref*
Enumeration roleRefs = descriptor.getSecurityRoleReferences();
SecurityRoleRefNode roleRefNode = new SecurityRoleRefNode();
while (roleRefs.hasMoreElements()) {
roleRefNode.writeDescriptor(myNode, WebTagNames.ROLE_REFERENCE,
(RoleReference) roleRefs.nextElement());
}
// multipart-config
MultipartConfigDescriptor multipartConfigDesc =
(MultipartConfigDescriptor)descriptor.getMultipartConfig();
if (multipartConfigDesc != null) {
MultipartConfigNode multipartConfigNode = new MultipartConfigNode();
multipartConfigNode.writeDescriptor(myNode, WebTagNames.MULTIPART_CONFIG,
multipartConfigDesc);
}
return myNode;
}
}