com.sun.faces.facelets.compiler.SAXCompiler Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jsf-impl Show documentation
Show all versions of jsf-impl Show documentation
This is the master POM file for Oracle's Implementation of the JSF 2.2 Specification.
/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright (c) 1997-2010 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.
*
*
* This file incorporates work covered by the following copyright and
* permission notice:
*
* Copyright 2005-2007 The Apache Software Foundation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.sun.faces.facelets.compiler;
import static com.sun.faces.config.WebConfiguration.BooleanWebContextInitParameter.DisallowDoctypeDecl;
import com.sun.faces.RIConstants;
import com.sun.faces.config.FaceletsConfiguration;
import com.sun.faces.config.WebConfiguration;
import com.sun.faces.facelets.tag.TagAttributeImpl;
import com.sun.faces.facelets.tag.TagAttributesImpl;
import com.sun.faces.util.Util;
import org.xml.sax.*;
import org.xml.sax.ext.LexicalHandler;
import org.xml.sax.helpers.DefaultHandler;
import javax.faces.view.Location;
import javax.faces.view.facelets.*;
import javax.xml.parsers.ParserConfigurationException;
import javax.xml.parsers.SAXParser;
import javax.xml.parsers.SAXParserFactory;
import java.io.BufferedInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.net.URL;
import java.util.logging.Level;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
import javax.faces.context.ExternalContext;
import javax.faces.context.FacesContext;
/**
* Compiler implementation that uses SAX
*
* @author Jacob Hookom
* @see Compiler
* @version $Id$
*/
public final class SAXCompiler extends Compiler {
private final static Pattern XmlDeclaration = Pattern.compile("^<\\?xml.+?version=['\"](.+?)['\"](.+?encoding=['\"]((.+?))['\"])?.*?\\?>");
private static class CompilationHandler extends DefaultHandler implements
LexicalHandler {
protected final String alias;
protected boolean inDocument = false;
protected Locator locator;
protected final CompilationManager unit;
public CompilationHandler(CompilationManager unit, String alias) {
this.unit = unit;
this.alias = alias;
}
public void characters(char[] ch, int start, int length)
throws SAXException {
if (this.inDocument) {
this.unit.writeText(new String(ch, start, length));
}
}
public void comment(char[] ch, int start, int length)
throws SAXException {
if (this.inDocument) {
if (!unit.getWebConfiguration().getFaceletsConfiguration().isConsumeComments(alias)) {
this.unit.writeComment(new String(ch, start, length));
}
}
}
protected TagAttributesImpl createAttributes(Attributes attrs) {
int len = attrs.getLength();
TagAttributeImpl[] ta = new TagAttributeImpl[len];
for (int i = 0; i < len; i++) {
ta[i] = new TagAttributeImpl(this.createLocation(),
attrs.getURI(i), attrs.getLocalName(i), attrs
.getQName(i), attrs.getValue(i));
}
return new TagAttributesImpl(ta);
}
protected Location createLocation() {
Location result = null;
if (null != locator) {
result = new Location(this.alias, this.locator.getLineNumber(),
this.locator.getColumnNumber());
} else {
if (log.isLoggable(Level.SEVERE)) {
log.log(Level.SEVERE, "Unable to create Location due to null locator instance variable.");
}
}
return result;
}
public void endCDATA() throws SAXException {
if (this.inDocument) {
if (!unit.getWebConfiguration().getFaceletsConfiguration().isConsumeCDATA(alias)) {
this.unit.writeInstruction("]]>");
}
}
}
public void endDocument() throws SAXException {
super.endDocument();
}
public void endDTD() throws SAXException {
this.inDocument = true;
}
public void endElement(String uri, String localName, String qName)
throws SAXException {
this.unit.popTag();
}
public void endEntity(String name) throws SAXException {
}
public void endPrefixMapping(String prefix) throws SAXException {
this.unit.popNamespace(prefix);
}
public void fatalError(SAXParseException e) throws SAXException {
if (this.locator != null) {
throw new SAXException("Error Traced[line: "
+ this.locator.getLineNumber() + "] " + e.getMessage());
} else {
throw e;
}
}
public void ignorableWhitespace(char[] ch, int start, int length)
throws SAXException {
if (this.inDocument) {
this.unit.writeWhitespace(new String(ch, start, length));
}
}
public InputSource resolveEntity(String publicId, String systemId)
throws SAXException {
String dtd = "com/sun/faces/xhtml/default.dtd";
/*if ("-//W3C//DTD XHTML 1.0 Transitional//EN".equals(publicId)) {
dtd = "xhtml1-transitional.dtd";
} else if (systemId != null && systemId.startsWith("file:/")) {
return new InputSource(systemId);
}*/
URL url = this.getClass().getClassLoader().getResource(dtd);
return new InputSource(url.toString());
}
public void setDocumentLocator(Locator locator) {
this.locator = locator;
}
public void startCDATA() throws SAXException {
if (this.inDocument) {
if (!unit.getWebConfiguration().getFaceletsConfiguration().isConsumeCDATA(alias)) {
this.unit.writeInstruction("\n");
// It is essential to save the doctype here because this is the
// *only* time we will have access to it.
Util.saveDOCTYPEToFacesContextAttributes(sb.toString());
}
this.inDocument = false;
}
public void startElement(String uri, String localName, String qName,
Attributes attributes) throws SAXException {
TagAttributes tagAttrs = this.createAttributes(attributes);
Tag tag = new Tag(this.createLocation(), uri, localName, qName, tagAttrs);
tagAttrs.setTag(tag);
this.unit.pushTag(tag);
}
public void startEntity(String name) throws SAXException {
}
public void startPrefixMapping(String prefix, String uri)
throws SAXException {
this.unit.pushNamespace(prefix, uri);
}
public void processingInstruction(String target, String data)
throws SAXException {
if (this.inDocument) {
// If there is a process-as value for the extension, only allow
// the PI to be written if its value is xhtml
boolean processAsXhtml =
this.unit.getWebConfiguration().getFaceletsConfiguration().isProcessCurrentDocumentAsFaceletsXhtml(alias);
if (processAsXhtml) {
StringBuffer sb = new StringBuffer(64);
sb.append("\n");
this.unit.writeInstruction(sb.toString());
}
}
}
protected boolean isDisallowDoctypeDeclSet() {
return unit.getWebConfiguration().isSet(DisallowDoctypeDecl);
}
protected boolean isDisallowDoctypeDecl() {
return unit.getWebConfiguration().isOptionEnabled(DisallowDoctypeDecl);
}
}
private static class MetadataCompilationHandler extends CompilationHandler {
private static final String METADATA_HANDLER = "metadata";
private boolean processingMetadata = false;
private boolean metadataProcessed = false;
// -------------------------------------------------------- Constructors
public MetadataCompilationHandler(CompilationManager unit, String alias) {
super(unit, alias);
}
// ------------------------------------- Methods from CompilationHandler
@Override
public void characters(char[] ch, int start, int length)
throws SAXException {
if (!metadataProcessed) {
if (processingMetadata) {
// PENDING consider optimizing this to be a no-op
// on whitespace, but don't instantiate the String
// just to test that.
this.unit.writeText(new String(ch, start, length));
}
}
}
@Override
public void comment(char[] ch, int start, int length)
throws SAXException {
// no-op
}
@Override
public void endCDATA() throws SAXException {
// no-op
}
@Override
public void ignorableWhitespace(char[] ch, int start, int length)
throws SAXException {
// no-op
}
@Override
public void startCDATA() throws SAXException {
// no-op
}
@Override
public void startDTD(String name, String publicId, String systemId)
throws SAXException {
// no-op
}
@Override
public void startEntity(String name) throws SAXException {
// no-op
}
@Override
public void processingInstruction(String target, String data)
throws SAXException {
// no-op
}
@Override
public void startElement(String uri, String localName, String qName, Attributes attributes)
throws SAXException {
if (!metadataProcessed) {
if (!processingMetadata &&
(RIConstants.CORE_NAMESPACE.equals(uri) ||
RIConstants.CORE_NAMESPACE_NEW.equals(uri)
)) {
if (METADATA_HANDLER.equals(localName)) {
processingMetadata = true;
}
}
if (processingMetadata) {
super.startElement(uri, localName, qName, attributes);
}
}
if ((localName.equals("view") &&
(RIConstants.CORE_NAMESPACE.equals(uri) || RIConstants.CORE_NAMESPACE_NEW.equals(uri)))) {
super.startElement(uri, localName, qName, attributes);
}
}
@Override
public void endElement(String uri, String localName, String qName)
throws SAXException {
if (!metadataProcessed) {
if (processingMetadata) {
super.endElement(uri, localName, qName);
}
if (processingMetadata &&
(RIConstants.CORE_NAMESPACE.equals(uri) ||
RIConstants.CORE_NAMESPACE_NEW.equals(uri)
)) {
if (METADATA_HANDLER.equals(localName)) {
processingMetadata = false;
metadataProcessed = true;
}
}
}
if ((localName.equals("view") &&
(RIConstants.CORE_NAMESPACE.equals(uri) || RIConstants.CORE_NAMESPACE_NEW.equals(uri)))) {
super.endElement(uri, localName, qName);
}
}
}
public SAXCompiler() {
super();
}
public FaceletHandler doCompile(URL src, String alias) throws IOException {
CompilationManager mgr = new CompilationManager(alias, this);
CompilationHandler handler = new CompilationHandler(mgr, alias);
return doCompile(mgr, handler, src, alias);
}
public FaceletHandler doMetadataCompile(URL src, String alias)
throws IOException {
CompilationManager mgr = new CompilationManager("metadata/" + alias, this);
CompilationHandler handler = new MetadataCompilationHandler(mgr, alias);
return doCompile(mgr, handler, src, alias);
}
protected FaceletHandler doCompile(CompilationManager mngr,
CompilationHandler handler,
URL src,
String alias)
throws IOException {
InputStream is = null;
String encoding = getEncoding();
try {
is = new BufferedInputStream(src.openStream(), 1024);
writeXmlDecl(is, encoding, mngr);
SAXParser parser = this.createSAXParser(handler);
parser.parse(is, handler);
} catch (SAXException e) {
throw new FaceletException("Error Parsing " + alias + ": "
+ e.getMessage(), e.getCause());
} catch (ParserConfigurationException e) {
throw new FaceletException("Error Configuring Parser " + alias
+ ": " + e.getMessage(), e.getCause());
} catch (FaceletException e) {
throw e;
} finally {
if (is != null) {
is.close();
}
}
FaceletHandler result = new EncodingHandler(mngr.createFaceletHandler(), encoding,
mngr.getCompilationMessageHolder());
mngr.setCompilationMessageHolder(null);
return result;
}
private String getEncoding() {
String result;
String encodingFromRequest = null;
FacesContext context = FacesContext.getCurrentInstance();
if (null != context) {
ExternalContext extContext = context.getExternalContext();
encodingFromRequest = extContext.getRequestCharacterEncoding();
}
result = (null != encodingFromRequest) ? encodingFromRequest : RIConstants.CHAR_ENCODING;
return result;
}
protected static void writeXmlDecl(InputStream is, String encoding, CompilationManager mngr)
throws IOException {
is.mark(128);
try {
byte[] b = new byte[128];
if (is.read(b) > 0) {
String r = new String(b, encoding);
Matcher m = XmlDeclaration.matcher(r);
if (m.find()) {
WebConfiguration config = mngr.getWebConfiguration();
FaceletsConfiguration faceletsConfig = config.getFaceletsConfiguration();
boolean currentModeIsXhtml = faceletsConfig.isProcessCurrentDocumentAsFaceletsXhtml(mngr.getAlias());
// We want to write the XML declaration if and only if
// the file extension for the current file has a mapping
// with the value of XHTML
if (currentModeIsXhtml) {
Util.saveXMLDECLToFacesContextAttributes(m.group(0) + "\n");
}
}
}
} finally {
is.reset();
}
}
private SAXParser createSAXParser(CompilationHandler handler)
throws SAXException, ParserConfigurationException {
SAXParserFactory factory = Util.createSAXParserFactory();
factory.setNamespaceAware(true);
factory.setFeature("http://xml.org/sax/features/namespace-prefixes",
true);
factory.setFeature("http://xml.org/sax/features/validation", this
.isValidating());
factory.setValidating(this.isValidating());
if (handler.isDisallowDoctypeDeclSet()) {
factory.setFeature("http://apache.org/xml/features/disallow-doctype-decl", handler.isDisallowDoctypeDecl());
}
SAXParser parser = factory.newSAXParser();
XMLReader reader = parser.getXMLReader();
reader.setProperty("http://xml.org/sax/properties/lexical-handler",
handler);
reader.setErrorHandler(handler);
reader.setEntityResolver(handler);
return parser;
}
}