// Copyright 2006 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 org.apache.tapestry.internal.services;
import static java.lang.String.format;
import static org.apache.tapestry.ioc.internal.util.CollectionFactory.newSet;
import static org.easymock.EasyMock.contains;
import java.util.Arrays;
import java.util.List;
import java.util.Set;
import org.apache.commons.logging.Log;
import org.apache.tapestry.internal.parser.AttributeToken;
import org.apache.tapestry.internal.parser.BlockToken;
import org.apache.tapestry.internal.parser.BodyToken;
import org.apache.tapestry.internal.parser.CDATAToken;
import org.apache.tapestry.internal.parser.CommentToken;
import org.apache.tapestry.internal.parser.ComponentTemplate;
import org.apache.tapestry.internal.parser.EndElementToken;
import org.apache.tapestry.internal.parser.ExpansionToken;
import org.apache.tapestry.internal.parser.ParameterToken;
import org.apache.tapestry.internal.parser.StartComponentToken;
import org.apache.tapestry.internal.parser.StartElementToken;
import org.apache.tapestry.internal.parser.TemplateToken;
import org.apache.tapestry.internal.parser.TextToken;
import org.apache.tapestry.internal.parser.TokenType;
import org.apache.tapestry.ioc.Locatable;
import org.apache.tapestry.ioc.Location;
import org.apache.tapestry.ioc.Resource;
import org.apache.tapestry.ioc.internal.util.ClasspathResource;
import org.apache.tapestry.ioc.internal.util.TapestryException;
import org.apache.tapestry.test.TapestryTestCase;
import org.testng.annotations.DataProvider;
import org.testng.annotations.Test;
/**
* This is used to test the template parser ... and in some cases, the underlying behavior of the
* SAX APIs.
*/
public class TemplateParserImplTest extends TapestryTestCase
{
private TemplateParser newParser(Log log)
{
return new TemplateParserImpl(log);
}
private synchronized ComponentTemplate parse(Log log, String file)
{
Resource resource = getResource(file);
return newParser(log).parseTemplate(resource);
}
private ComponentTemplate parse(String file)
{
Log log = newLog();
replay();
ComponentTemplate result = parse(log, file);
verify();
return result;
}
private List<TemplateToken> tokens(String file)
{
Log log = newLog();
replay();
List<TemplateToken> tokens = parse(log, file).getTokens();
verify();
return tokens;
}
private Resource getResource(String file)
{
String packageName = getClass().getPackage().getName();
String path = packageName.replace('.', '/') + "/" + file;
ClassLoader loader = getClass().getClassLoader();
return new ClasspathResource(loader, path);
}
@SuppressWarnings("unchecked")
private <T extends TemplateToken> T get(List l, int index)
{
Object raw = l.get(index);
return (T) raw;
}
private void checkLine(Locatable l, int expectedLineNumber)
{
assertEquals(l.getLocation().getLine(), expectedLineNumber);
}
@Test
synchronized void just_HTML()
{
Log log = newLog();
Resource resource = getResource("justHTML.html");
replay();
ComponentTemplate template = newParser(log).parseTemplate(resource);
assertSame(template.getResource(), resource);
List<TemplateToken> tokens = template.getTokens();
// They add up quick ...
assertEquals(tokens.size(), 20);
StartElementToken t0 = get(tokens, 0);
// Spot check a few things ...
assertEquals(t0.getName(), "html");
checkLine(t0, 1);
TextToken t1 = get(tokens, 1);
// Concerned this may not work cross platform.
assertEquals(t1.getText(), "\n ");
StartElementToken t2 = get(tokens, 2);
assertEquals(t2.getName(), "head");
checkLine(t2, 2);
TextToken t5 = get(tokens, 5);
assertEquals(t5.getText(), "title");
checkLine(t5, 3);
get(tokens, 6);
StartElementToken t12 = get(tokens, 12);
assertEquals(t12.getName(), "p");
AttributeToken t13 = get(tokens, 13);
assertEquals(t13.getName(), "class");
assertEquals(t13.getValue(), "important");
TextToken t14 = get(tokens, 14);
// Simplify the text, converting consecutive whitespace to just a single space.
assertEquals(t14.getText().replaceAll("\\s+", " ").trim(), "Tapestry rocks! Line 2");
// Line number is the *start* line of the whole text block.
checkLine(t14, 6);
verify();
}
@Test
void xml_entity()
{
List<TemplateToken> tokens = tokens("xmlEntity.html");
assertEquals(tokens.size(), 3);
TextToken t = get(tokens, 1);
// This is OK because the org.apache.tapestry.dom.Text will convert the characters back into
// XML entities.
assertEquals(t.getText().trim(), "lt:< gt:> amp:&");
}
/** Test disabled when not online. */
@Test(enabled = false)
void html_entity()
{
List<TemplateToken> tokens = tokens("html_entity.html");
assertEquals(tokens.size(), 3);
TextToken t = get(tokens, 1);
// HTML entities are parsed into values that will ultimately
// be output as numeric entities. This is less than ideal; would like
// to find a way to keep the entities in their original form (possibly
// involving a new type of token), but SAX seems to be fighting me on this.
// You have to have a DOCTYPE just to parse a template that uses
// an HTML entity.
assertEquals(t.getText().trim(), "nbsp:[\u00a0]");
}
@Test
void cdata()
{
List<TemplateToken> tokens = tokens("cdata.html");
// Whitespace text tokens around the CDATA
assertEquals(tokens.size(), 5);
CDATAToken t = get(tokens, 2);
assertEquals(t.getText(), "CDATA: <foo> & <bar> and <baz>");
checkLine(t, 2);
}
@Test
void comment()
{
List<TemplateToken> tokens = tokens("comment.html");
// Again, whitespace before and after the comment adds some tokens
assertEquals(tokens.size(), 5);
CommentToken t = get(tokens, 2);
// Comments are now trimmed of leading and trailing whitespace. This may mean
// that the output isn't precisely what's in the template, but a) its a comment
// and b) that's pretty much true of everything in the templates.
assertEquals(t.getComment(), "Single line comment");
}
@Test
void multiline_comment()
{
List<TemplateToken> tokens = tokens("multilineComment.html");
// Again, whitespace before and after the comment adds some tokens
assertEquals(tokens.size(), 5);
CommentToken t = get(tokens, 2);
String comment = t.getComment().trim().replaceAll("\\s+", " ");
assertEquals(comment, "Line one Line two Line three");
}
@Test
void component()
{
List<TemplateToken> tokens = tokens("component.html");
assertEquals(tokens.size(), 6);
StartComponentToken t = get(tokens, 2);
assertEquals(t.getId(), "fred");
assertEquals(t.getType(), "Fred");
assertNull(t.getMixins());
checkLine(t, 2);
get(tokens, 3);
}
@Test
void component_with_body()
{
List<TemplateToken> tokens = tokens("componentWithBody.html");
assertEquals(tokens.size(), 7);
get(tokens, 2);
TextToken t = get(tokens, 3);
assertEquals(t.getText().trim(), "fred's body");
get(tokens, 4);
}
@Test
public void root_element_is_component()
{
List<TemplateToken> tokens = tokens("root_element_is_component.html");
assertEquals(tokens.size(), 3);
StartComponentToken start = get(tokens, 0);
assertEquals(start.getId(), "fred");
assertEquals(start.getType(), "Fred");
assertNull(start.getElementName());
AttributeToken attr = get(tokens, 1);
assertEquals(attr.getName(), "param");
assertEquals(attr.getValue(), "value");
assertTrue(EndElementToken.class.isInstance(tokens.get(2)));
}
@Test
public void instrumented_element()
{
ComponentTemplate template = parse("instrumented_element.html");
List<TemplateToken> tokens = template.getTokens();
assertEquals(tokens.size(), 3);
StartComponentToken start = get(tokens, 0);
assertEquals(start.getId(), "fred");
assertEquals(start.getType(), "Fred");
assertEquals(start.getElementName(), "html");
AttributeToken attr = get(tokens, 1);
assertEquals(attr.getName(), "param");
assertEquals(attr.getValue(), "value");
assertTrue(EndElementToken.class.isInstance(tokens.get(2)));
assertEquals(template.getComponentIds(), Arrays.asList("fred"));
}
@Test
void body_element()
{
List<TemplateToken> tokens = tokens("body_element.html");
// start(html), text, body, text, end(html)
assertEquals(tokens.size(), 5);
// javac bug requires use of isInstance() instead of instanceof
// https://bugs.eclipse.org/bugs/show_bug.cgi?id=113218
assertTrue(BodyToken.class.isInstance(get(tokens, 2)));
}
@Test
void content_within_body_element()
{
Log log = newLog();
log.error(contains("Content inside a Tapestry body element is not allowed"));
replay();
List<TemplateToken> tokens = parse(log, "content_within_body_element.html").getTokens();
assertEquals(tokens.size(), 5);
// javac bug is requires use of isInstance() instead of instanceof
// https://bugs.eclipse.org/bugs/show_bug.cgi?id=113218
assertTrue(BodyToken.class.isInstance(get(tokens, 2)));
assertTrue(TextToken.class.isInstance(get(tokens, 3)));
assertTrue(EndElementToken.class.isInstance(get(tokens, 4)));
verify();
}
@Test
void component_with_parameters()
{
List<TemplateToken> tokens = tokens("componentWithParameters.html");
assertEquals(tokens.size(), 9);
TemplateToken templateToken = get(tokens, 2);
Location l = templateToken.getLocation();
AttributeToken t1 = get(tokens, 3);
// TODO: Not sure what order the attributes appear in. Order in the XML? Sorted
// alphabetically? Random 'cause they're hashed?
assertEquals(t1.getName(), "cherry");
assertEquals(t1.getValue(), "bomb");
assertSame(t1.getLocation(), l);
AttributeToken t2 = get(tokens, 4);
assertEquals(t2.getName(), "align");
assertEquals(t2.getValue(), "right");
assertSame(t2.getLocation(), l);
TextToken t3 = get(tokens, 5);
assertEquals(t3.getText().trim(), "fred's body");
get(tokens, 6);
}
@Test
public void component_with_mixins()
{
List<TemplateToken> tokens = tokens("component_with_mixins.html");
assertEquals(tokens.size(), 6);
StartComponentToken t = get(tokens, 2);
assertEquals(t.getId(), "fred");
assertNull(t.getType());
assertEquals(t.getMixins(), "Barney");
}
@Test
public void empty_string_mixins_is_null()
{
List<TemplateToken> tokens = tokens("empty_string_mixins_is_null.html");
assertEquals(tokens.size(), 6);
StartComponentToken t = get(tokens, 2);
assertEquals(t.getId(), "fred");
// We also check that empty string type is null ..
assertNull(t.getType());
assertNull(t.getMixins());
}
@Test
public void component_ids()
{
Log log = newLog();
replay();
ComponentTemplate template = parse(log, "component_ids.html");
Set<String> ids = template.getComponentIds();
assertEquals(ids, newSet(Arrays.asList("bomb", "border", "zebra")));
verify();
}
@Test
public void expansions_in_normal_text()
{
List<TemplateToken> tokens = tokens("expansions_in_normal_text.html");
assertEquals(tokens.size(), 7);
TextToken t1 = get(tokens, 1);
assertEquals(t1.getText().trim(), "Expansion #1[");
ExpansionToken t2 = get(tokens, 2);
assertEquals(t2.getExpression(), "expansion1");
TextToken t3 = get(tokens, 3);
assertEquals(t3.getText().replaceAll("\\s+", " "), "] Expansion #2[");
ExpansionToken t4 = get(tokens, 4);
assertEquals(t4.getExpression(), "expansion2");
TextToken t5 = get(tokens, 5);
assertEquals(t5.getText().trim(), "]");
}
@Test
public void expansions_must_be_on_one_line()
{
List<TemplateToken> tokens = tokens("expansions_must_be_on_one_line.html");
assertEquals(tokens.size(), 3);
TextToken t1 = get(tokens, 1);
assertEquals(
t1.getText().replaceAll("\\s+", " "),
" ${expansions must be on a single line} ");
}
@Test
public void multiple_expansions_on_one_line()
{
List<TemplateToken> tokens = tokens("multiple_expansions_on_one_line.html");
assertEquals(tokens.size(), 10);
ExpansionToken token3 = get(tokens, 3);
assertEquals(token3.getExpression(), "classLoader");
TextToken token4 = get(tokens, 4);
assertEquals(token4.getText(), " [");
ExpansionToken token5 = get(tokens, 5);
assertEquals(token5.getExpression(), "classLoader.class.name");
TextToken token6 = get(tokens, 6);
assertEquals(token6.getText(), "]");
}
@Test
public void expansions_not_allowed_in_cdata()
{
List<TemplateToken> tokens = tokens("expansions_not_allowed_in_cdata.html");
assertEquals(tokens.size(), 5);
CDATAToken t2 = get(tokens, 2);
assertEquals(t2.getText(), "${not-an-expansion}");
}
@Test
public void expansions_not_allowed_in_attributes()
{
List<TemplateToken> tokens = tokens("expansions_not_allowed_in_attributes.html");
assertEquals(tokens.size(), 4);
AttributeToken t1 = get(tokens, 1);
assertEquals(t1.getName(), "exp");
assertEquals(t1.getValue(), "${not-an-expansion}");
}
@Test
public void parameter_element()
{
List<TemplateToken> tokens = tokens("parameter_element.html");
ParameterToken token4 = get(tokens, 4);
assertEquals(token4.getName(), "fred");
CommentToken token6 = get(tokens, 6);
assertEquals(token6.getComment(), "fred content");
TemplateToken token8 = get(tokens, 8);
assertEquals(token8.getTokenType(), TokenType.END_ELEMENT);
}
@Test
public void block_element()
{
List<TemplateToken> tokens = tokens("block_element.html");
BlockToken token2 = get(tokens, 2);
assertEquals(token2.getId(), "block0");
CommentToken token4 = get(tokens, 4);
assertEquals(token4.getComment(), "block0 content");
BlockToken token8 = get(tokens, 8);
assertNull(token8.getId());
CommentToken token10 = get(tokens, 10);
assertEquals(token10.getComment(), "anon block content");
}
@DataProvider(name = "parse_failure_data")
public Object[][] parse_failure_data()
{
return new Object[][]
{
{
"mixin_requires_id_or_type.html",
"You may not specify mixins for element <span> because it does not represent a component (which requires either an id attribute or a type attribute).",
2 },
{ "illegal_nesting_within_body_element.html",
"Element 'xyz' is nested within a Tapestry body element", 2 },
{ "component_without_id_or_type.html", ServicesMessages.compRequiresIdOrType(), 2 },
{
"unexpected_element_in_tapestry_namespace.html",
"Element <t:fubar> is in the Tapestry namespace, but is not a recognized Tapestry template element.",
3 },
{
"unexpected_attribute_in_parameter_element.html",
"Element <parameter> does not support an attribute named 'grok'. The only allowed attribute name is 'name'.",
4 },
{ "name_attribute_of_parameter_element_omitted.html",
"The name attribute of the <parameter> element must be specified.", 4 },
{ "name_attribute_of_parameter_element_blank.html",
"The name attribute of the <parameter> element must be specified.", 4 },
{
"unexpected_attribute_in_block_element.html",
"Element <block> does not support an attribute named 'name'. The only allowed attribute name is 'id'.",
3 },
};
}
@Test(dataProvider = "parse_failure_data")
public void parse_failure(String fileName, String errorMessageSubstring, int expectedLine)
{
try
{
parse(fileName);
unreachable();
}
catch (TapestryException ex)
{
if (!ex.getMessage().contains(errorMessageSubstring))
{
throw new AssertionError(format("Message [%s] does not contain substring [%s].", ex
.getMessage(), errorMessageSubstring));
}
assertEquals(ex.getLocation().getLine(), expectedLine);
}
}
}