sitemesh-2.4.1+dfsg.orig/ 0000755 0001750 0001750 00000000000 11340277634 015162 5 ustar twerner twerner sitemesh-2.4.1+dfsg.orig/LICENSE.txt 0000644 0001750 0001750 00000004652 10125024250 016774 0 ustar twerner twerner ====================================================================
The OpenSymphony Software License, Version 1.1
(this license is derived and fully compatible with the Apache Software
License - see http://www.apache.org/LICENSE.txt)
Copyright (c) 2001 The OpenSymphony Group. All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in
the documentation and/or other materials provided with the
distribution.
3. The end-user documentation included with the redistribution,
if any, must include the following acknowledgment:
"This product includes software developed by the
OpenSymphony Group (http://www.opensymphony.com/)."
Alternately, this acknowledgment may appear in the software itself,
if and wherever such third-party acknowledgments normally appear.
4. The names "OpenSymphony" and "The OpenSymphony Group"
must not be used to endorse or promote products derived from this
software without prior written permission. For written
permission, please contact license@opensymphony.com .
5. Products derived from this software may not be called "OpenSymphony"
or "SiteMesh", nor may "OpenSymphony" or "SiteMesh" appear in their
name, without prior written permission of the OpenSymphony Group.
THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.
====================================================================
sitemesh-2.4.1+dfsg.orig/CHANGES.txt 0000644 0001750 0001750 00000023734 11157162354 017002 0 ustar twerner twerner --------------------------
-- Changes in 2.4.1 --
--------------------------
Fixed error in Page.getRequest() implementation. Now deprecated and removed from examples.
--------------------------
-- Changes in 2.4 --
--------------------------
Mostly minor fixes.
Bug fixes
* [SIM-156] - Style Tags are stripped from
* [SIM-172] - Unclosed quotes cause parsing problems
* [SIM-180] - Header content after a tag gets treated as part of the body
* [SIM-186] - SM should honor (at least) 304 (SC_NOT_MODIFIED)
* [SIM-197] - when bodyContent is null,page:applyDecorator will throw NullPointerException
* [SIM-198] - Deleted '<' in included content
* [SIM-206] - XML Declaration in XHTML
* [SIM-216] - NoSuchElementException in com.opensymphony.module.sitemesh.html.HTMLProcessor$1.currentBuffer(HTMLProcessor.java:44)
* [SIM-241] - ArrayIndexOutofBounds exception in HTMLPageParser
* [SIM-247] - OSDecoratorMapper == FAIL
* [SIM-249] - tlds are broken - shortname does not conform to NMTOKEN
Improvements
* [SIM-151] - Allow the forced session creation to be optional
* [SIM-174] - Simple (but measurable) Performance improvements for DefaultFactory and ConfigLoader
* [SIM-192] - Need more user-friendly log error message when decorators.xml is missing
Tasks
* [SIM-229] - Update Sitemesh testsuite to use Cargo
* [SIM-230] - Remove PageFilter, in favour of new SiteMeshFilter
--------------------------
-- Changes in 2.3 --
--------------------------
Default parser has been moved from FastPageParser to HTMLPageParser.
Misc bug fixes.
Added components to enable decorators to be built with Tapestry (contributed by Erik Hatcher).
--------------------------
-- Changes in 2.2.1 --
--------------------------
SiteMesh 2.2 introduced a few critical bugs, which have stopped it
from being a seamless upgrade to many users.
-- Fixed critical bugs --
* ClassNotFound: DefaultPageParser
This is a class that no longer exists but may still lurk in
sitemesh.xml if based on a 1.0 version. The config loader now just
silently ignores this.
* Head of content page chopped off
This was caused by setContentType() always resetting the buffer,
however sometimes setContentType() was called half way through a page
(for instance by the Servlet engine whilst doing an include).
--------------------------
-- Changes in 2.2 --
--------------------------
This release fixes a number of minor bugs, and no code changes are required
from 2.1.
The following improvements have been made:
- The tag in decorators.xml now takes into account ServletPath, PathInfo and QueryString.
- Overhaul of the main Servlet Filter to remove unnecessary complexity and more gracefully handle situations
where the order of calls on the HttpServletResponse, PrintWriter and ServletOutputStream occur in an
awkward order.
JIRA issues fixed:
- SIM-125 Internal Tomcat CGI throws NullPointerException.
- SIM-128 HTML parser cannot handle attributes that span multiple lines.
- SIM-86 Requests that use setHeader("Content-type") instead of setContentType() do not get decorated.
- SIM-134 Not calling setContentType() caused NullPointerException.
--------------------------
-- Changes in 2.1 --
--------------------------
This release fixes a number of major bugs, and no code changes are required
from 2.0.1. We recommend all users upgrade.
This release mainly contains application server compatibilty changes.
Sitemesh is now compatible with more servers than ever before, and this
release fixes the number one bug which was decoration of static pages under
Tomcat.
- The URI's for the SiteMesh tag libraries have changed:
sitemesh-decorator becomes http://www.opensymphony.com/sitemesh/decorator
sitemesh-page becomes http://www.opensymphony.com/sitemesh/page
There have been no other changes to the tag library descriptors (.tld) files from
the previous version, so you don't need to replace you existing ones.
- Added VelocityDecoratorServlet (SIM-62; see 'Velocity Decorators' in the documentation and the example webapp).
- The example webapp and blank webapp use Packaged Tag Libraries (specifying the URI of the taglib).
- Hardened ConfigLoader to ignore whitespace inserted by XMLBuddy.
- A new method, isPathExcluded(), has been added to the Factory interface (SIM-98)
- There is no longer the concept of a default parser for unknown content types.
JIRA issues fixed:
- SIM-82 IllegalStateException when decorating static pages in Tomcat 4 & 5
- SIM-114 Sitemesh truncates content on non-decorated pages.
- SIM-73 PageFilter is not final and you can now subclass the newly protected applyDecorator and parsePage methods
- SIM-83 RequestDispatcher.forward() support
- SIM-91 Remove singleton configuration
- SIM-55 applyDecorator tag doesn't work on resin
- SIM-73 Make PageFilter subclassable
- SIM-89 mapping on deployment descriptor
- SIM-97 Sitemesh captures the response even for non-parseable content
- SIM-98 Add the ability to exclude content from being decorated
--------------------------
-- Changes from 2.0 --
--------------------------
Chris Miller has been working like a demon on FastPageParser, and it's now as
fast and efficient as it can get. To give you a rough idea, 2.0 is about 3 times
faster than 1.5. 2.0.1 is about 5 times faster than 1.5.
With regards to memory usage, it's basically been knocked down to be negligible.
Previously (1.5), a 50k page parsed 250 times (separate instances strongly
referenced, with an explicit gc call to remove temporary objects) used up 37mb.
Currently, it uses 25mb (and it's no coincidence that 50k * 250 * 2 bytes per
char == 25mb).
- Minor DTD fix.
- Updates to documentation and build process.
- Added ParserGrinder to load test FastPageParser.
--------------------------
-- Changes from 1.5 --
--------------------------
- SiteMesh now hosted at http://sitemesh.dev.java.net.
- FastPageParser performance improvements.
- DTD location has changed; now http://www.opensymphony.com/sitemesh/dtd/sitemesh_1_5_decorators.dtd
- API change in Decorator (check your custom written Decorator classes):
Added new method getRole() to enable role based decorators.
- Updated documentation to align with new Opensymphony website.
JIRA issues fixed:
SIM-16 Tomcat IllegalStateException
SIM-41 NoSuchMethodException with Orion
SIM-2 Response bug on WebLogic 6.1
SIM-13 Tomcat4 throws IOException after response.sendRedirect()
SIM-29 WebLogic 7 doesn't work
SIM-40 Let properties be retrieved programatically
SIM-27 Example apps don't work in Pramati
SIM-17 Can't set headers from decorator page.
SIM-8 body tag not correctly parsed
SIM-56 Decorator taglibs allowed to contain body
SIM-37 role based decorators
SIM-46 Place TLDs in Jar file.
--------------------------
-- Changes from 1.4.1 --
--------------------------
- API change in DecoratorMapper (check your custom written DecoratorMappers):
before
Decorator getNamedDecorator(String name);
after
Decorator getNamedDecorator(HttpServletRequest request, String name);
- API change in Decorator (check your custom written Decorator classes):
Added new method getURIPath() to enable cross web-app support for decorators.
- New (shorter!) decorator xml format (backward compability is maintained),
check above or the decorators.xml file in the /example/WEB-INF directory for an example.
DTD: http://www.opensymphony.com/sitemesh/dtd/sitemesh_1_5_decorators.dtd
- Default SiteMesh configuration if sitemesh.xml is not present.
- When the request contains a Page object (under the key RequestConstants.PAGE)
use this one (supports SiteMesh aware applications) so we don't need to parse.
- EnvEntryDecoratorMapper: allows the reference to a web-app environment entry for the
decorator name, and falls back to ConfigDecoratorMapper's behavior if no matching
environment entry is found.
- Cross web-app support for decorators by specifying .
This will first try to get the decorator from anotherwebapp and fall back if not found.
- Small performance improvements in RobotDecoratorMapper.
- Some improvements to get SiteMesh working on different web containers.
If you need to detect on which container your application is running,
have a look at the com.opensymphony.module.sitemesh.util.Container class.
- BUGFIX: DefaultDecorator returned bad init param
- BUGFIX: small fixes to make SiteMesh work better on Tomcat
- BUGFIX: javadoc fixes
JIRA issues fixed:
SIM-1 Finalize RE support in PathMapper
SIM-3 Page filter strips tags
SIM-4 PathMapper order is incorrect
SIM-5 Add a mapper that uses environment entries
SIM-6 When using the EnvEntryDecoratorMapper, decorations fail for html
SIM-7 Parsing of body should strip doctype
SIM-8 body tag not correctly parsed
SIM-11 Parsing the text "<>" causes problems
SIM-16 Define how charsets should work
SIM-20 Cross web-app support for decorators
SIM-21 FactoryException thrown when starting testsuite on WebLogic
SIM-22 Create template web-app
SIM-23 Distribution bundle
SIM-32 A smaller than sign (<) in javascript fails
--------------------------
-- Changes from 1.4 --
--------------------------
- complete support for WebLogic 6.1 / 7
- complete support for Jetty 4
- internal optimizations to filter
- BUGFIX: StringIndexOutOfBoundsException in RobotDecoratorMapper
--------------------------
-- Changes from 1.3 --
--------------------------
- changed package structure from com.sitemesh to com.opensymphony.module.sitemesh
- many performance optimizations in FastPageParser
- various bug fixes and small performance improvements
- BUGFIX: memory leak in PageFilter
- BUGFIX: meta http-equiv tags are now added as properties with prefix meta.http-equiv.x where x
is the value of the http-equiv attribute (eg refresh)
- BUGFIX: the configuration files are not case-sensitive anymore
sitemesh-2.4.1+dfsg.orig/README.txt 0000644 0001750 0001750 00000013122 11157162236 016654 0 ustar twerner twerner *************************************
** OpenSymphony SiteMesh 2.4.1 **
*************************************
SiteMesh is a web-page layout system that can be used to abstract common look
and feel from the functionality of a web-application and to assemble large
webpages from smaller components. Pages and components can have meta-data
extracted from them (such as body, title and meta-tags) which can be used by
decorators (skins) that are applied.
SiteMesh won't tread on your toes or force you to work in a certain way (except
for cleaner) - you install and carry on working as before. It seamlessly fits in
with existing frameworks.
Forget the hype - just try it! You'll be impressed with how it can simplify
things.
--------------------------
-- Obtaining --
--------------------------
The latest version of SiteMesh can be obtained from:
http://www.opensymphony.com/sitemesh/
--------------------------
-- Requirements --
--------------------------
SiteMesh requires a Java Servlet container conforming to the Servlet 2.3
specification. Versions prior to 2.3 are not enough.
Currently known containers that support this and SiteMesh was tested with:
* Orion 1.5.4 and up - http://www.orionserver.com
* Tomcat 4.0, 4.1 and 5.0.19 - http://jakarta.apache.org/tomcat
* Resin 2.1.11, 2.1.12, 2.1.13 and 3.0.7 - http://www.caucho.com
* Oracle OC4J 2 - http://www.oracle.com
* WebLogic 7.0 SP2, 8.1 and 8.1 SP2 - http://www.bea.com
* WebSphere 5.0 - http://www.ibm.com
* Jetty 4.2.20 - http://jetty.mortbay.org
--------------------------
-- Installation --
--------------------------
* Copy sitemesh-@VERSION@.jar to the WEB-INF/lib/ directory of your web-app.
* OPTIONAL: Copy sitemesh.xml to the WEB-INF/ directory if you need to specify a custom
decorator mapper configuration then the default configuration.
* Add the following to WEB-INF/web.xml:
sitemeshcom.opensymphony.sitemesh.webapp.SiteMeshFiltersitemesh/*
* ORION USERS ONLY. For performance reasons, Orion does not auto-load tab library descriptors
from Jars by default. To get passed this you will also have to copy sitemesh-decorator.tld
and sitemesh-page.tld to WEB-INF/lib and add the following to WEB-INF/web.xml:
http://www.opensymphony.com/sitemesh/decorator/WEB-INF/lib/sitemesh-decorator.tldhttp://www.opensymphony.com/sitemesh/page/WEB-INF/lib/sitemesh-page.tld
--------------------------
-- Getting started --
--------------------------
Ok, let's assume you have some basic JSPs already on the site.
These should contain vanilla HTML.
If you don't, here's a JSP to get you started (test.jsp).
Hello world
Today is <%= new java.util.Date() %>.
Once you have some content (preferably more imaginative than the example above),
a decorator should be created (decorator.jsp).
<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %>
My Site -
Now you need tell SiteMesh about that decorator and when to use it. Create the
file WEB-INF/decorators.xml:
/*
Access your original JSP (test.jsp) though your web-browser and it should look
pretty normal. Now if you add some styling to your decorator it shall
automatically be applied to all the other pages in your web-app.
You can define as many decorators as you want in decorators.xml. Example:
/*/subdir/**.html*.htm/anotherdir/*
--------------------------
-- Further support --
--------------------------
You get the idea. Play around. See the SiteMesh website for
full documentation.
http://www.opensymphony.com/sitemesh/
--------------------------
-- Credits --
--------------------------
Thank these guys:
* Mathias Bogaert
* Mike Cannon-Brookes
* Victor Salaman
* Joseph Ottinger
* Hani Suleiman
* Scott Farquhar
- Joe Walnes
sitemesh-2.4.1+dfsg.orig/build.xml 0000644 0001750 0001750 00000016554 10446416452 017015 0 ustar twerner twerner
sitemesh-2.4.1+dfsg.orig/lib/ 0000755 0001750 0001750 00000000000 11157130030 015710 5 ustar twerner twerner sitemesh-2.4.1+dfsg.orig/docs/ 0000755 0001750 0001750 00000000000 11157130004 016073 5 ustar twerner twerner sitemesh-2.4.1+dfsg.orig/docs/features.html 0000644 0001750 0001750 00000003373 11157162710 020616 0 ustar twerner twerner
SiteMesh Feature List
Java
Built with Java, the industry standard for enterprise applications.
Open source software distributed under the OpenSymphony Software License (derived and fully compatible with the Apache Software License).
Simple
Non-technical users can now create professional Web pages while
effortlessly maintaining a consistent look-and-feel across your web-application.
Dramatically reduces the time needed to develop and maintain a web-application.
Eliminates the need to create multiple web-apps for different audiences by
allowing the decorator to be changed according to the useragent or a request parameter(s) (e.g. printable version).
Very flexible
A printable version of your entire site is only a matter of minutes!
Map a decorator based on a cookie value.
With the RobotDecoratorMapper you can apply a special decorator to all your pages when
they are indexed by a search engine robot (also known as spider, crawler). Currently supports over 200 robots.