1.0.1. "Commercial Use" means distribution or otherwise making the
+ Covered Code available to a third party.
+
1.1. ''Contributor'' means each entity that creates or contributes
+ to the creation of Modifications.
+
1.2. ''Contributor Version'' means the combination of the Original
+ Code, prior Modifications used by a Contributor, and the Modifications made by
+ that particular Contributor.
+
1.3. ''Covered Code'' means the Original Code or Modifications or
+ the combination of the Original Code and Modifications, in each case including
+ portions thereof.
+
1.4. ''Electronic Distribution Mechanism'' means a mechanism
+ generally accepted in the software development community for the electronic
+ transfer of data.
+
1.5. ''Executable'' means Covered Code in any form other than Source
+ Code.
+
1.6. ''Initial Developer'' means the individual or entity identified
+ as the Initial Developer in the Source Code notice required by Exhibit
+ A.
+
1.7. ''Larger Work'' means a work which combines Covered Code or
+ portions thereof with code not governed by the terms of this License.
+
1.8. ''License'' means this document.
+
1.8.1. "Licensable" means having the right to grant, to the maximum
+ extent possible, whether at the time of the initial grant or subsequently
+ acquired, any and all of the rights conveyed herein.
+
1.9. ''Modifications'' means any addition to or deletion from the
+ substance or structure of either the Original Code or any previous
+ Modifications. When Covered Code is released as a series of files, a
+ Modification is:
+
A. Any addition to or deletion from the contents of a file
+ containing Original Code or previous Modifications.
+
B. Any new file that contains any part of the Original Code or
+ previous Modifications.
1.10. ''Original Code''
+ means Source Code of computer software code which is described in the Source
+ Code notice required by Exhibit A as Original Code, and which, at the
+ time of its release under this License is not already Covered Code governed by
+ this License.
+
1.10.1. "Patent Claims" means any patent claim(s), now owned or
+ hereafter acquired, including without limitation, method, process, and
+ apparatus claims, in any patent Licensable by grantor.
+
1.11. ''Source Code'' means the preferred form of the Covered Code
+ for making modifications to it, including all modules it contains, plus any
+ associated interface definition files, scripts used to control compilation and
+ installation of an Executable, or source code differential comparisons against
+ either the Original Code or another well known, available Covered Code of the
+ Contributor's choice. The Source Code can be in a compressed or archival form,
+ provided the appropriate decompression or de-archiving software is widely
+ available for no charge.
+
1.12. "You'' (or "Your") means an individual or a legal entity
+ exercising rights under, and complying with all of the terms of, this License
+ or a future version of this License issued under Section 6.1. For legal
+ entities, "You'' includes any entity which controls, is controlled by, or is
+ under common control with You. For purposes of this definition, "control''
+ means (a) the power, direct or indirect, to cause the direction or management
+ of such entity, whether by contract or otherwise, or (b) ownership of more
+ than fifty percent (50%) of the outstanding shares or beneficial ownership of
+ such entity.
2. Source Code License.
+
2.1. The Initial Developer Grant. The Initial Developer hereby
+ grants You a world-wide, royalty-free, non-exclusive license, subject to third
+ party intellectual property claims:
+
(a)under intellectual property rights (other than
+ patent or trademark) Licensable by Initial Developer to use, reproduce,
+ modify, display, perform, sublicense and distribute the Original Code (or
+ portions thereof) with or without Modifications, and/or as part of a Larger
+ Work; and
+
(b) under Patents Claims infringed by the making, using or selling
+ of Original Code, to make, have made, use, practice, sell, and offer for
+ sale, and/or otherwise dispose of the Original Code (or portions thereof).
+
+
(c) the licenses granted in this Section 2.1(a) and (b)
+ are effective on the date Initial Developer first distributes Original Code
+ under the terms of this License.
+
(d) Notwithstanding Section 2.1(b) above, no patent license is
+ granted: 1) for code that You delete from the Original Code; 2) separate
+ from the Original Code; or 3) for infringements caused by: i) the
+ modification of the Original Code or ii) the combination of the Original
+ Code with other software or devices.
2.2. Contributor
+ Grant. Subject to third party intellectual property claims, each
+ Contributor hereby grants You a world-wide, royalty-free, non-exclusive
+ license
+
(a)under intellectual property rights (other
+ than patent or trademark) Licensable by Contributor, to use, reproduce,
+ modify, display, perform, sublicense and distribute the Modifications
+ created by such Contributor (or portions thereof) either on an unmodified
+ basis, with other Modifications, as Covered Code and/or as part of a Larger
+ Work; and
+
(b) under Patent Claims infringed by the making, using, or selling
+ of Modifications made by that Contributor either alone and/or in combination with its Contributor Version (or portions of such
+ combination), to make, use, sell, offer for sale, have made, and/or
+ otherwise dispose of: 1) Modifications made by that Contributor (or portions
+ thereof); and 2) the combination of Modifications made by that
+ Contributor with its Contributor Version (or portions of such
+ combination).
+
(c) the licenses granted in Sections 2.2(a) and 2.2(b) are
+ effective on the date Contributor first makes Commercial Use of the Covered
+ Code.
+
(d) Notwithstanding Section 2.2(b) above, no
+ patent license is granted: 1) for any code that Contributor has deleted from
+ the Contributor Version; 2) separate from the Contributor
+ Version; 3) for infringements caused by: i) third party
+ modifications of Contributor Version or ii) the combination of
+ Modifications made by that Contributor with other software (except as
+ part of the Contributor Version) or other devices; or 4) under Patent Claims
+ infringed by Covered Code in the absence of Modifications made by that
+ Contributor.
+
3. Distribution Obligations.
+
3.1. Application of License. The Modifications which You create
+ or to which You contribute are governed by the terms of this License,
+ including without limitation Section 2.2. The Source Code version of
+ Covered Code may be distributed only under the terms of this License or a
+ future version of this License released under Section 6.1, and You must
+ include a copy of this License with every copy of the Source Code You
+ distribute. You may not offer or impose any terms on any Source Code version
+ that alters or restricts the applicable version of this License or the
+ recipients' rights hereunder. However, You may include an additional document
+ offering the additional rights described in Section 3.5.
+
3.2. Availability of Source Code. Any Modification which You
+ create or to which You contribute must be made available in Source Code form
+ under the terms of this License either on the same media as an Executable
+ version or via an accepted Electronic Distribution Mechanism to anyone to whom
+ you made an Executable version available; and if made available via Electronic
+ Distribution Mechanism, must remain available for at least twelve (12) months
+ after the date it initially became available, or at least six (6) months after
+ a subsequent version of that particular Modification has been made available
+ to such recipients. You are responsible for ensuring that the Source Code
+ version remains available even if the Electronic Distribution Mechanism is
+ maintained by a third party.
+
3.3. Description of Modifications. You must cause all Covered
+ Code to which You contribute to contain a file documenting the changes You
+ made to create that Covered Code and the date of any change. You must include
+ a prominent statement that the Modification is derived, directly or
+ indirectly, from Original Code provided by the Initial Developer and including
+ the name of the Initial Developer in (a) the Source Code, and (b) in any
+ notice in an Executable version or related documentation in which You describe
+ the origin or ownership of the Covered Code.
+
3.4. Intellectual Property Matters
+
(a) Third Party Claims. If Contributor has knowledge that a
+ license under a third party's intellectual property rights is required to
+ exercise the rights granted by such Contributor under Sections 2.1 or 2.2,
+ Contributor must include a text file with the Source Code distribution
+ titled "LEGAL'' which describes the claim and the party making the claim in
+ sufficient detail that a recipient will know whom to contact. If Contributor
+ obtains such knowledge after the Modification is made available as described
+ in Section 3.2, Contributor shall promptly modify the LEGAL file in all
+ copies Contributor makes available thereafter and shall take other steps
+ (such as notifying appropriate mailing lists or newsgroups) reasonably
+ calculated to inform those who received the Covered Code that new knowledge
+ has been obtained.
+
(b) Contributor APIs. If Contributor's Modifications include
+ an application programming interface and Contributor has knowledge of patent
+ licenses which are reasonably necessary to implement that API, Contributor
+ must also include this information in the LEGAL file.
+
+ (c) Representations.
+
Contributor represents that, except as disclosed pursuant to Section
+ 3.4(a) above, Contributor believes that Contributor's Modifications are
+ Contributor's original creation(s) and/or Contributor has sufficient rights
+ to grant the rights conveyed by this License.
+
3.5. Required Notices. You must duplicate the notice in
+ Exhibit A in each file of the Source Code. If it is not possible
+ to put such notice in a particular Source Code file due to its structure, then
+ You must include such notice in a location (such as a relevant directory)
+ where a user would be likely to look for such a notice. If You created
+ one or more Modification(s) You may add your name as a Contributor to the
+ notice described in Exhibit A. You must also duplicate this
+ License in any documentation for the Source Code where You describe
+ recipients' rights or ownership rights relating to Covered Code. You may
+ choose to offer, and to charge a fee for, warranty, support, indemnity or
+ liability obligations to one or more recipients of Covered Code. However, You
+ may do so only on Your own behalf, and not on behalf of the Initial Developer
+ or any Contributor. You must make it absolutely clear than any such warranty,
+ support, indemnity or liability obligation is offered by You alone, and You
+ hereby agree to indemnify the Initial Developer and every Contributor for any
+ liability incurred by the Initial Developer or such Contributor as a result of
+ warranty, support, indemnity or liability terms You offer.
+
3.6. Distribution of Executable Versions. You may distribute
+ Covered Code in Executable form only if the requirements of Section
+ 3.1-3.5 have been met for that Covered Code, and if You include a
+ notice stating that the Source Code version of the Covered Code is available
+ under the terms of this License, including a description of how and where You
+ have fulfilled the obligations of Section 3.2. The notice must be
+ conspicuously included in any notice in an Executable version, related
+ documentation or collateral in which You describe recipients' rights relating
+ to the Covered Code. You may distribute the Executable version of Covered Code
+ or ownership rights under a license of Your choice, which may contain terms
+ different from this License, provided that You are in compliance with the
+ terms of this License and that the license for the Executable version does not
+ attempt to limit or alter the recipient's rights in the Source Code version
+ from the rights set forth in this License. If You distribute the Executable
+ version under a different license You must make it absolutely clear that any
+ terms which differ from this License are offered by You alone, not by the
+ Initial Developer or any Contributor. You hereby agree to indemnify the
+ Initial Developer and every Contributor for any liability incurred by the
+ Initial Developer or such Contributor as a result of any such terms You offer.
+
+
3.7. Larger Works. You may create a Larger Work by combining
+ Covered Code with other code not governed by the terms of this License and
+ distribute the Larger Work as a single product. In such a case, You must make
+ sure the requirements of this License are fulfilled for the Covered
+Code.
4. Inability to Comply Due to Statute or Regulation.
+
If it is impossible for You to comply with any of the terms of this
+ License with respect to some or all of the Covered Code due to statute,
+ judicial order, or regulation then You must: (a) comply with the terms of this
+ License to the maximum extent possible; and (b) describe the limitations and
+ the code they affect. Such description must be included in the LEGAL file
+ described in Section 3.4 and must be included with all distributions of
+ the Source Code. Except to the extent prohibited by statute or regulation,
+ such description must be sufficiently detailed for a recipient of ordinary
+ skill to be able to understand it.
5. Application of this License.
+
This License applies to code to which the Initial Developer has attached
+ the notice in Exhibit A and to related Covered Code.
6. Versions
+of the License.
+
6.1. New Versions. Netscape Communications Corporation
+ (''Netscape'') may publish revised and/or new versions of the License from
+ time to time. Each version will be given a distinguishing version number.
+
6.2. Effect of New Versions. Once Covered Code has been
+ published under a particular version of the License, You may always continue
+ to use it under the terms of that version. You may also choose to use such
+ Covered Code under the terms of any subsequent version of the License
+ published by Netscape. No one other than Netscape has the right to modify the
+ terms applicable to Covered Code created under this License.
+
6.3. Derivative Works. If You create or use a modified version
+ of this License (which you may only do in order to apply it to code which is
+ not already Covered Code governed by this License), You must (a) rename Your
+ license so that the phrases ''Mozilla'', ''MOZILLAPL'', ''MOZPL'',
+ ''Netscape'', "MPL", ''NPL'' or any confusingly similar phrase do not appear
+ in your license (except to note that your license differs from this License)
+ and (b) otherwise make it clear that Your version of the license contains
+ terms which differ from the Mozilla Public License and Netscape Public
+ License. (Filling in the name of the Initial Developer, Original Code or
+ Contributor in the notice described in Exhibit A shall not of
+ themselves be deemed to be modifications of this License.)
7.
+DISCLAIMER OF WARRANTY.
+
COVERED CODE IS PROVIDED UNDER THIS LICENSE ON AN "AS IS'' BASIS, WITHOUT
+ WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
+ LIMITATION, WARRANTIES THAT THE COVERED CODE IS FREE OF DEFECTS, MERCHANTABLE,
+ FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE
+ QUALITY AND PERFORMANCE OF THE COVERED CODE IS WITH YOU. SHOULD ANY COVERED
+ CODE PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL DEVELOPER OR ANY
+ OTHER CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR
+ CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
+ LICENSE. NO USE OF ANY COVERED CODE IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS
+ DISCLAIMER.
8. TERMINATION.
+
8.1. This License and the rights granted hereunder will
+ terminate automatically if You fail to comply with terms herein and fail to
+ cure such breach within 30 days of becoming aware of the breach. All
+ sublicenses to the Covered Code which are properly granted shall survive any
+ termination of this License. Provisions which, by their nature, must remain in
+ effect beyond the termination of this License shall survive.
+
8.2. If You initiate litigation by asserting a patent
+ infringement claim (excluding declatory judgment actions) against Initial
+ Developer or a Contributor (the Initial Developer or Contributor against whom
+ You file such action is referred to as "Participant") alleging that:
+
(a) such Participant's Contributor Version directly or
+ indirectly infringes any patent, then any and all rights granted by such
+ Participant to You under Sections 2.1 and/or 2.2 of this License shall, upon
+ 60 days notice from Participant terminate prospectively, unless if within 60
+ days after receipt of notice You either: (i) agree in writing to pay
+ Participant a mutually agreeable reasonable royalty for Your past and future
+ use of Modifications made by such Participant, or (ii) withdraw Your
+ litigation claim with respect to the Contributor Version against such
+ Participant. If within 60 days of notice, a reasonable royalty and
+ payment arrangement are not mutually agreed upon in writing by the parties or
+ the litigation claim is not withdrawn, the rights granted by Participant to
+ You under Sections 2.1 and/or 2.2 automatically terminate at the expiration of
+ the 60 day notice period specified above.
+
(b) any software, hardware, or device, other than such
+ Participant's Contributor Version, directly or indirectly infringes any
+ patent, then any rights granted to You by such Participant under Sections
+ 2.1(b) and 2.2(b) are revoked effective as of the date You first made, used,
+ sold, distributed, or had made, Modifications made by that Participant.
+
8.3. If You assert a patent infringement claim against
+ Participant alleging that such Participant's Contributor Version directly or
+ indirectly infringes any patent where such claim is resolved (such as by
+ license or settlement) prior to the initiation of patent infringement
+ litigation, then the reasonable value of the licenses granted by such
+ Participant under Sections 2.1 or 2.2 shall be taken into account in
+ determining the amount or value of any payment or license.
+
8.4. In the event of termination under Sections 8.1 or 8.2
+ above, all end user license agreements (excluding distributors and
+ resellers) which have been validly granted by You or any distributor hereunder
+ prior to termination shall survive termination.
9. LIMITATION OF
+LIABILITY.
+
UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER TORT (INCLUDING
+ NEGLIGENCE), CONTRACT, OR OTHERWISE, SHALL YOU, THE INITIAL DEVELOPER, ANY
+ OTHER CONTRIBUTOR, OR ANY DISTRIBUTOR OF COVERED CODE, OR ANY SUPPLIER OF ANY
+ OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR ANY INDIRECT, SPECIAL,
+ INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT
+ LIMITATION, DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
+ MALFUNCTION, OR ANY AND ALL OTHER COMMERCIAL DAMAGES OR LOSSES, EVEN IF SUCH
+ PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES. THIS
+ LIMITATION OF LIABILITY SHALL NOT APPLY TO LIABILITY FOR DEATH OR PERSONAL
+ INJURY RESULTING FROM SUCH PARTY'S NEGLIGENCE TO THE EXTENT APPLICABLE LAW
+ PROHIBITS SUCH LIMITATION. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR
+ LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THIS EXCLUSION AND
+ LIMITATION MAY NOT APPLY TO YOU.
10. U.S. GOVERNMENT END USERS.
+
The Covered Code is a ''commercial item,'' as that term is defined in 48
+ C.F.R. 2.101 (Oct. 1995), consisting of ''commercial computer software'' and
+ ''commercial computer software documentation,'' as such terms are used in 48
+ C.F.R. 12.212 (Sept. 1995). Consistent with 48 C.F.R. 12.212 and 48 C.F.R.
+ 227.7202-1 through 227.7202-4 (June 1995), all U.S. Government End Users
+ acquire Covered Code with only those rights set forth herein.
11.
+MISCELLANEOUS.
+
This License represents the complete agreement concerning subject matter
+ hereof. If any provision of this License is held to be unenforceable, such
+ provision shall be reformed only to the extent necessary to make it
+ enforceable. This License shall be governed by California law provisions
+ (except to the extent applicable law, if any, provides otherwise), excluding
+ its conflict-of-law provisions. With respect to disputes in which at least one
+ party is a citizen of, or an entity chartered or registered to do business in
+ the United States of America, any litigation relating to this License shall be
+ subject to the jurisdiction of the Federal Courts of the Northern District of
+ California, with venue lying in Santa Clara County, California, with the
+ losing party responsible for costs, including without limitation, court costs
+ and reasonable attorneys' fees and expenses. The application of the United
+ Nations Convention on Contracts for the International Sale of Goods is
+ expressly excluded. Any law or regulation which provides that the language of
+ a contract shall be construed against the drafter shall not apply to this
+ License.
12. RESPONSIBILITY FOR CLAIMS.
+
As between Initial Developer and the Contributors, each party is
+ responsible for claims and damages arising, directly or indirectly, out of its
+ utilization of rights under this License and You agree to work with Initial
+ Developer and Contributors to distribute such responsibility on an equitable
+ basis. Nothing herein is intended or shall be deemed to constitute any
+ admission of liability.
13. MULTIPLE-LICENSED CODE.
+
Initial Developer may designate portions of the Covered Code as
+ �Multiple-Licensed?. �Multiple-Licensed? means that the Initial
+ Developer permits you to utilize portions of the Covered Code under Your
+ choice of the MPL or the alternative licenses, if any, specified by the
+ Initial Developer in the file described in Exhibit A.
+
EXHIBIT A -Mozilla Public License.
+
The contents of this file are subject to the Mozilla Public License
+ Version 1.1 (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.mozilla.org/MPL/
+
Software distributed under the License is distributed on an "AS IS" basis,
+ WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
+ for the specific language governing rights and limitations under the
+ License.
+
The Original Code is Javassist.
+
The Initial Developer of the Original Code is Shigeru Chiba.
+ Portions created by the Initial Developer are
+ Copyright (C) 1999-2008 Shigeru Chiba. All Rights Reserved.
+
Alternatively, the contents of this file may be used under the terms of
+ the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
+ in which case the provisions of the LGPL are applicable instead
+ of those above. If you wish to allow use of your version of this file only
+ under the terms of the LGPL, and not to allow others to
+ use your version of this file under the terms of the MPL, indicate your
+ decision by deleting the provisions above and replace them with the notice
+ and other provisions required by the LGPL. If you do not delete
+ the provisions above, a recipient may use your version of this file under
+ the terms of either the MPL or the LGPL.
+
+
+
+
diff --git a/Java-base/tiles/src/LICENSE.txt b/Java-base/tiles/src/LICENSE.txt
new file mode 100644
index 000000000..d64569567
--- /dev/null
+++ b/Java-base/tiles/src/LICENSE.txt
@@ -0,0 +1,202 @@
+
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ 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.
diff --git a/Java-base/tiles/src/NOTICE.txt b/Java-base/tiles/src/NOTICE.txt
new file mode 100644
index 000000000..c622f7a84
--- /dev/null
+++ b/Java-base/tiles/src/NOTICE.txt
@@ -0,0 +1,15 @@
+ Apache Tiles
+ Copyright 1999-2012 The Apache Software Foundation
+
+ This product includes software developed at
+ The Apache Software Foundation (http://www.apache.org/).
+
+ The binary distribution contains software developed by:
+
+ SpringSource: http://www.springsource.com/
+ Visigoth Software Society (Freemarker): http://freemarker.org/
+ OpenSymphony (OGNL): http://www.opensymphony.com/ognl/
+ Codehaus (MVEL): http://mvel.codehaus.org/
+ JBoss (Javassist): http://jboss.org/javassist/
+ Sam Pullara (Mustache Java): https://github.com/spullara/mustache.java/
+
diff --git a/Java-base/tiles/src/OGNL-LICENSE.txt b/Java-base/tiles/src/OGNL-LICENSE.txt
new file mode 100644
index 000000000..43bafbbb5
--- /dev/null
+++ b/Java-base/tiles/src/OGNL-LICENSE.txt
@@ -0,0 +1,50 @@
+/* ====================================================================
+ * 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-2004 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 "OGNL", nor may "OpenSymphony" or "OGNL" 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.
+ * ====================================================================
+ */
diff --git a/Java-base/tiles/src/SLF4J-LICENSE.txt b/Java-base/tiles/src/SLF4J-LICENSE.txt
new file mode 100644
index 000000000..f5ecafa00
--- /dev/null
+++ b/Java-base/tiles/src/SLF4J-LICENSE.txt
@@ -0,0 +1,21 @@
+Copyright (c) 2004-2008 QOS.ch
+All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/Java-base/tiles/src/assembly/pom.xml b/Java-base/tiles/src/assembly/pom.xml
new file mode 100644
index 000000000..53ff030b9
--- /dev/null
+++ b/Java-base/tiles/src/assembly/pom.xml
@@ -0,0 +1,203 @@
+
+
+
+
+ 4.0.0
+ org.apache.tiles
+ tiles-assembly
+ pom
+ Tiles Assembly
+ Tiles Assembly: assembles artifact to produce distributions.
+
+
+
+ org.apache.tiles
+ tiles-parent
+ 3.1-SNAPSHOT
+
+
+
+ scm:svn:http://svn.apache.org/repos/asf/tiles/framework/trunk/assembly
+ scm:svn:https://svn.apache.org/repos/asf/tiles/framework/trunk/assembly
+ http://svn.apache.org/viewcvs.cgi/tiles/framework/trunk/assembly
+
+
+
+
+
+ org.apache.maven.plugins
+ maven-assembly-plugin
+ 2.2-beta-4
+
+
+ src/main/assembly/bin.xml
+ src/main/assembly/docs.xml
+ src/main/assembly/src.xml
+
+ tiles-${project.version}
+ target/assembly/out
+ target/assembly/work
+ gnu
+
+
+
+
+
+
+ apache-release
+
+
+
+ org.apache.maven.plugins
+ maven-assembly-plugin
+ 3.1.0
+
+
+ make-assembly
+
+ single
+
+ package
+
+
+
+
+ src/main/assembly/bin.xml
+ src/main/assembly/docs.xml
+ src/main/assembly/src.xml
+
+ gnu
+
+
+
+ org.apache.maven.plugins
+ maven-deploy-plugin
+
+ true
+
+
+
+ net.nicoulaj.maven.plugins
+ checksum-maven-plugin
+ 1.6
+
+
+
+ artifacts
+
+
+
+
+ true
+
+
+
+ org.apache.maven.plugins
+ maven-gpg-plugin
+
+ ${project.build.directory}/..
+
+
+
+ org.apache.maven.plugins
+ maven-antrun-plugin
+ 1.8
+
+
+ deploy
+
+ run
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ org.apache.tiles
+ tiles-api
+
+
+
+ org.apache.tiles
+ tiles-core
+
+
+
+ org.apache.tiles
+ tiles-servlet
+
+
+
+ org.apache.tiles
+ tiles-jsp
+ ${project.version}
+
+
+
+ org.apache.tiles
+ tiles-compat
+ ${project.version}
+
+
+
+ org.apache.tiles
+ tiles-test
+ ${project.version}
+ war
+
+
+
+ org.apache.tiles
+ tiles-extras
+ ${project.version}
+ jar
+
+
+
+
+ org.slf4j
+ slf4j-jdk14
+ runtime
+
+
+
+
+
diff --git a/Java-base/tiles/src/assembly/src/main/assembly/bin.xml b/Java-base/tiles/src/assembly/src/main/assembly/bin.xml
new file mode 100644
index 000000000..5fee0959b
--- /dev/null
+++ b/Java-base/tiles/src/assembly/src/main/assembly/bin.xml
@@ -0,0 +1,68 @@
+
+
+ bin
+
+ tar.gz
+ zip
+
+ false
+
+
+ /lib
+ ${artifact.artifactId}-${artifact.version}${dashClassifier?}.${artifact.extension}
+
+ org.slf4j:slf4j-api
+ org.slf4j:jcl-over-slf4j
+ commons-beanutils:commons-beanutils
+ commons-digester:commons-digester
+
+
+
+ /lib/optional
+ ${artifact.artifactId}-${artifact.version}${dashClassifier?}.${artifact.extension}
+
+ org.apache.tiles:*
+ org.slf4j:slf4j-api
+ org.slf4j:jcl-over-slf4j
+ commons-beanutils:commons-beanutils
+ commons-digester:commons-digester
+
+
+
+ /
+ ${artifact.artifactId}-${artifact.version}${dashClassifier?}.${artifact.extension}
+
+ org.apache.tiles:*
+
+
+ org.apache.tiles:tiles-test
+
+
+
+
+
+
+ ..
+ /
+
+ *LICENSE.*
+ NOTICE.txt
+
+
+
+
diff --git a/Java-base/tiles/src/assembly/src/main/assembly/docs.xml b/Java-base/tiles/src/assembly/src/main/assembly/docs.xml
new file mode 100644
index 000000000..72fae5544
--- /dev/null
+++ b/Java-base/tiles/src/assembly/src/main/assembly/docs.xml
@@ -0,0 +1,49 @@
+
+
+ docs
+
+ tar.gz
+ zip
+
+ false
+
+
+
+
+
+ ..
+ /
+
+ LICENSE.txt
+ NOTICE.txt
+
+
+
+ ../target/site/apidocs
+ apidocs
+
+
+ ../tiles-core/target/site/dtddoc
+ dtddoc
+
+
+ ../tiles-jsp/target/site/tlddoc
+ tlddoc
+
+
+
diff --git a/Java-base/tiles/src/assembly/src/main/assembly/src.xml b/Java-base/tiles/src/assembly/src/main/assembly/src.xml
new file mode 100644
index 000000000..79c9b4c87
--- /dev/null
+++ b/Java-base/tiles/src/assembly/src/main/assembly/src.xml
@@ -0,0 +1,153 @@
+
+
+ src
+
+ tar.gz
+ zip
+
+
+
+ ../
+ src/
+
+ pom.xml
+ src/
+
+
+
+ ../
+ /
+
+ LICENSE.txt
+ NOTICE.txt
+
+
+
+ ../tiles-core
+ src/tiles-core
+
+ pom.xml
+ src/
+
+
+
+ ../tiles-api
+ src/tiles-api
+
+ pom.xml
+ src/
+
+
+
+ ../tiles-servlet
+ src/tiles-servlet
+
+ pom.xml
+ src/
+
+
+
+ ../tiles-jsp
+ src/tiles-jsp
+
+ pom.xml
+ src/
+
+
+
+ ../tiles-el
+ src/tiles-el
+
+ pom.xml
+ src/
+
+
+
+ ../tiles-mvel
+ src/tiles-mvel
+
+ pom.xml
+ src/
+
+
+
+ ../tiles-ognl
+ src/tiles-ognl
+
+ pom.xml
+ src/
+
+
+
+ ../tiles-template
+ src/tiles-template
+
+ pom.xml
+ src/
+
+
+
+ ../tiles-freemarker
+ src/tiles-freemarker
+
+ pom.xml
+ src/
+
+
+
+ ../tiles-velocity
+ src/tiles-velocity
+
+ pom.xml
+ src/
+
+
+
+ ../tiles-extras
+ src/tiles-extras
+
+ pom.xml
+ src/
+
+
+
+ ../tiles-compat
+ src/tiles-compat
+
+ pom.xml
+ src/
+
+
+
+ ../tiles-test
+ src/tiles-test
+
+ pom.xml
+ src/
+
+
+
+ ../assembly
+ src/assembly
+
+ pom.xml
+ src/
+
+
+
+
diff --git a/Java-base/tiles/src/assembly/src/main/resources/LICENSE.txt b/Java-base/tiles/src/assembly/src/main/resources/LICENSE.txt
new file mode 100644
index 000000000..d64569567
--- /dev/null
+++ b/Java-base/tiles/src/assembly/src/main/resources/LICENSE.txt
@@ -0,0 +1,202 @@
+
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ 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.
diff --git a/Java-base/tiles/src/assembly/src/main/resources/NOTICE.txt b/Java-base/tiles/src/assembly/src/main/resources/NOTICE.txt
new file mode 100644
index 000000000..1f13ff856
--- /dev/null
+++ b/Java-base/tiles/src/assembly/src/main/resources/NOTICE.txt
@@ -0,0 +1,6 @@
+ Apache Tiles
+ Copyright 1999-2009 The Apache Software Foundation
+
+ This product includes software developed at
+ The Apache Software Foundation (http://www.apache.org/).
+
diff --git a/Java-base/tiles/src/assembly/src/site/site.xml b/Java-base/tiles/src/assembly/src/site/site.xml
new file mode 100644
index 000000000..de31de869
--- /dev/null
+++ b/Java-base/tiles/src/assembly/src/site/site.xml
@@ -0,0 +1,86 @@
+
+
+
+
+ org.apache.maven.skins
+ maven-fluido-skin
+ 1.3.0
+
+
+
+ true
+ false
+ true
+
+ apache/tiles
+ right
+ darkblue
+
+
+
+
+ Apache Tiles™
+ http://tiles.apache.org/images/logo.png
+ http://tiles.apache.org
+
+
+ Apache Software Foundation
+ http://struts.apache.org/images/asf-logo.gif
+ http://www.apache.org
+
+
+
+
+
+ ${modules}
+ ${reports}
+
+
+
+
+
diff --git a/Java-base/tiles/src/pom.xml b/Java-base/tiles/src/pom.xml
new file mode 100644
index 000000000..f023ddc35
--- /dev/null
+++ b/Java-base/tiles/src/pom.xml
@@ -0,0 +1,393 @@
+
+
+
+
+
+ tiles-master
+ org.apache.tiles
+ 7
+
+
+
+ 4.0.0
+ org.apache.tiles
+ tiles-parent
+ 3.1-SNAPSHOT
+ pom
+ Tiles 3
+ Tiles 3: A framework for page composition.
+ http://tiles.apache.org/framework/
+
+ scm:svn:http://svn.apache.org/repos/asf/tiles/framework/trunk/
+ scm:svn:https://svn.apache.org/repos/asf/tiles/framework/trunk/
+ http://svn.apache.org/viewvc/tiles/framework/trunk/
+
+
+
+
+
+ tiles-api
+ tiles-core
+ tiles-template
+ tiles-servlet
+ tiles-jsp
+ tiles-freemarker
+ tiles-velocity
+ tiles-el
+ tiles-mvel
+ tiles-ognl
+ tiles-compat
+ tiles-extras
+ assembly
+ tiles-test-pom
+
+
+
+ JIRA
+ https://issues.apache.org/jira/browse/TILES
+
+
+
+
+
+ apache-site
+ scp://people.apache.org/www/tiles.apache.org/framework
+
+
+
+
+
+ org.apache.tiles
+ tiles-api
+ ${project.version}
+
+
+ org.apache.tiles
+ tiles-core
+ ${project.version}
+
+
+ org.apache.tiles
+ tiles-servlet
+ ${project.version}
+
+
+ org.apache.tiles
+ tiles-template
+ ${project.version}
+
+
+
+ org.apache.velocity
+ velocity-tools
+ 2.0
+
+
+ struts-taglib
+ org.apache.struts
+
+
+ struts-tiles
+ org.apache.struts
+
+
+ struts-core
+ org.apache.struts
+
+
+ commons-logging
+ commons-logging
+
+
+ sslext
+ sslext
+
+
+ commons-chain
+ commons-chain
+
+
+ commons-validator
+ commons-validator
+
+
+ commons-digester
+ commons-digester
+
+
+ commons-beanutils
+ commons-beanutils
+
+
+ dom4j
+ dom4j
+
+
+
+
+
+ commons-digester
+ commons-digester
+ 2.0
+
+
+ commons-logging
+ commons-logging
+
+
+
+
+ org.freemarker
+ freemarker
+ 2.3.15
+
+
+
+ ognl
+ ognl
+ 2.7.3
+
+
+ org.mvel
+ mvel2
+ 2.3.2.Final
+
+
+ javax.servlet
+ servlet-api
+ 2.5
+ provided
+
+
+ javax.servlet.jsp
+ jsp-api
+ 2.1
+ provided
+
+
+ javax.el
+ el-api
+ 1.0
+ provided
+
+
+ junit
+ junit
+ 4.7
+ test
+
+
+ org.easymock
+ easymock
+ 3.0
+ test
+
+
+ org.apache.shale
+ shale-test
+ 1.0.5
+ test
+
+
+ org.easymock
+ easymockclassextension
+ 3.0
+ test
+
+
+ org.slf4j
+ slf4j-api
+ 1.7.6
+
+
+ org.slf4j
+ slf4j-jdk14
+ 1.7.6
+ test
+
+
+ org.slf4j
+ jcl-over-slf4j
+ 1.7.6
+ test
+
+
+ org.apache.tiles
+ tiles-request-api
+ ${tiles.request.version}
+
+
+
+
+
+
+
+
+ maven-jar-plugin
+
+
+ ${tiles.manifestfile}
+
+ true
+ true
+
+
+
+
+
+ org.apache.felix
+ maven-bundle-plugin
+ 2.3.7
+ true
+
+
+
+
+
+ org.apache.felix
+ maven-bundle-plugin
+
+ true
+ target/osgi
+
+ <_nouses>true
+ ${tiles.osgi.symbolicName}
+ ${tiles.osgi.export}
+ ${tiles.osgi.private}
+ ${tiles.osgi.import}
+ ${tiles.osgi.dynamicImport}
+ ${project.url}
+ ${project.name}
+ ${project.version}
+ ${project.organization.name}
+ ${project.name}
+ ${project.version}
+ ${project.organization.name}
+ org.apache
+
+
+
+
+ bundle-manifest
+ process-classes
+
+ manifest
+
+
+
+
+
+ org.apache.maven.plugins
+ maven-release-plugin
+
+ apache-release
+ deploy site-deploy
+
+
+
+
+ install
+
+
+
+ false
+ org.apache.${project.artifactId}
+ org.apache.tiles.*;version=${project.version}
+ *
+
+
+ target/osgi/MANIFEST.MF
+ UTF-8
+ 1.0.7
+ 1.1.0
+
+
+
+
+
+
+ apache-release
+
+
+
+ maven-install-plugin
+
+ true
+
+
+
+ org.codehaus.mojo
+ rat-maven-plugin
+ 1.0-alpha-3
+
+
+ verify
+
+ check
+
+
+ false
+
+
+ rat.analysis.license.ApacheSoftwareLicense20
+
+
+
+ pom.xml
+ src/**
+
+
+ **/*LICENSE.txt
+ **/*MANIFEST.MF
+
+
+
+
+
+
+
+
+
+ linkcheck
+
+
+
+ maven-linkcheck-plugin
+ 1.1
+
+
+ /*
+ **/index.html
+ **/logo.png
+ **/tiles-jsp/tagreference.html
+
+
+
+
+
+
+
+
+
+
diff --git a/Java-base/tiles/src/src/site/apt/config-reference.apt b/Java-base/tiles/src/src/site/apt/config-reference.apt
new file mode 100644
index 000000000..71a7b6dce
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/config-reference.apt
@@ -0,0 +1,250 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Tiles Configuration Reference
+ -----------
+
+Configuring Tiles
+
+ Configuring Tiles means creating the following objects:
+ * an instance of org.apache.tiles.request.ApplicationContext,
+ * an instance of org.apache.tiles.TilesContainer.
+ Usually these are created by an instance of org.apache.tiles.startup.TilesInitializer.
+
+ Several MVC frameworks (struts, spring, shale) provide an easy integration with tiles.
+
+* Starting Tiles in a web application
+
+ Tiles has always been a web application package, usually used in conjunction
+ with Struts. Apache Tiles\u0099 evolved to the point of being technology-independent, but
+ its use in a Servlet-based web application will be the most frequent use case.
+
+ To start Tiles you can extend
+ {{{./apidocs/org/apache/tiles/web/startup/AbstractTilesListener.html}AbstractTilesListener}}
+ and implement the <<>> method:
+
+--------------------------
+protected TilesInitializer createTilesInitializer() {
+ return new MyCustomTilesInitializer();
+}
+--------------------------
+
+ You can use {{{./apidocs/org/apache/tiles/startup/AbstractTilesInitializer.html}AbstractTilesInitializer}}
+ as a basis.
+
+ Then you can start Tiles by specifing it in your <<>> file:
+
+-------------------------------
+
+ my.package.MyTilesListener
+
+-------------------------------
+
+* Starting Tiles in a portlet application
+
+ TBD
+
+{Ready-made configuration classes}
+
+ There are some classes that allows to play with Tiles without writing custom code.
+
+* Simple configuration
+
+ {{{./apidocs/org/apache/tiles/web/startup/simple/SimpleTilesListener.html}SimpleTilesListener}}
+ or
+ {{{./apidocs/org/apache/tiles/startup/DefaultTilesInitializer.html}DefaultTilesInitializer}}
+ are the "simple" way to load Tiles. This was the default for Tiles 2.1 and prior versions.
+
+ This configuration has the following characteristics:
+
+ * loads the "/WEB-INF/tiles.xml" file;
+
+ * allows support for JSP, Servlets and Portlets;
+
+ * no expression language is allowed;
+
+ * wildcard expressions can be used to declare definition names.
+
+* Feature-Complete configuration
+
+ It is possible to startup Tiles turning all the new features on by using
+ {{{./apidocs/org/apache/tiles/extras/complete/CompleteAutoloadTilesListener.html}CompleteAutoloadTilesListener}}
+ or
+ {{{./apidocs/org/apache/tiles/extras/complete/CompleteAutoloadTilesInitializer.html}CompleteAutoloadTilesInitializer}}
+ available in the <<>> module. This initializer turns on:
+
+ * {{{./tutorial/integration/freemarker.html}Freemarker}} and {{{./tutorial/integration/velocity.html}Velocity}} support;
+
+ * using EL, OGNL and MVEL as {{{./tutorial/advanced/el-support.html}evaluation languages}};
+
+ * using Wildcards and Regular expression as {{{./tutorial/advanced/wildcard.html}pattern matching languages}};
+
+ * loading {{{./migration/configuration.html#Reusing_old_Tiles_configuration_files}Tiles 1.x definition files}};
+
+ * loads all the files named "tiles*.xml" under /WEB-INF and under every META-INF in any part of the classpath.
+
+ * using a mutable container to create Definitions at runtime.
+
+* Modular initialization
+
+ It is possible to startup Tiles in a <> way, that is loading
+ modules of independent Tiles configuration.
+
+ To turn it on, you need to use
+ {{{./apidocs/org/apache/tiles/extras/module/ModularTilesListener.html}ModularTilesListener}}
+ or
+ {{{./apidocs/org/apache/tiles/extras/module/ModularTilesInitializer.html}ModularTilesInitializer}}
+ available in the <<>> module.
+
+ Add in your manifest file, under the <<>>
+ path, the <<>> property, whose value is the name of the class of the
+ needed initializer. For example:
+
+---------------------------
+Manifest-Version: 1.0
+Tiles-Initializer: org.apache.tiles.extras.module.ModularTilesInitializerTest$TilesInitializer1
+---------------------------
+
+ Every initializer that is found will be loaded and "initialized", and destroyed when the
+ main initializer is destroyed.
+
+Configuring Tiles internals
+
+ The container and the application context must be configured to allow custom behaviour
+ and to load definitions from various sources.
+
+* Custom {ApplicationContext}
+
+ Custom ApplicationContext can be provided by implementing
+ {{{/tiles-request/apidocs/org/apache/tiles/request/ApplicationContext.html}ApplicationContext}}.
+ If you are under a servlet environment, you can override
+ {{{/tiles-request/apidocs/org/apache/tiles/request/servlet/ServletApplicationContext.html}ServletApplicationContext}}.
+
+ To use it, you need to override the
+ {{{./apidocs/org/apache/tiles/startup/AbstractTilesInitializer.html#method_summary}createTilesApplicationContext}}
+ method of AbstractTilesInitializer.
+
+ The reason to use a custom Tiles application context could be:
+
+ * supporting a platform not supported yet;
+
+ * providing custom behaviour, such as loading resources in a different manner.
+
+* Custom {TilesContainerFactory}
+
+ Custom Tiles containers can be created by custom Tiles container factories.
+ You have to create a class that extends
+ {{{./apidocs/org/apache/tiles/factory/AbstractTilesContainerFactory.html}AbstractTilesContainerFactory}}.
+ In particular you can use {{{./apidocs/org/apache/tiles/factory/BasicTilesContainerFactory.html}BasicTilesContainerFactory}}
+ as a basis for your extended configuration. <<>>
+ is the configuration that replicates the default configuration of Tiles,
+ i.e. the one that assumes when no additional parameter is provided.
+ The
+ {{{./apidocs/org/apache/tiles/factory/BasicTilesContainerFactory.html}Javadoc documentation of BasicTilesContainerFactory}}
+ documents all the methods that can be overridden to use your own
+ configuration.
+
+** Changing the path for the Tiles Definitions file
+
+ The <<>> loads the "/WEB-INF/tiles.xml" file; the <<>>
+ loads all the files named "tiles*.xml" under /WEB-INF and under every META-INF in any part of the classpath.
+
+ If this behaviour doesn't suits you, you can override the method <<>> and retrieve whatever resource you
+ prefer. Just specify the path for the default locale; Tiles will extrapolate and load the localized files as needed.
+
+* Custom components
+
+ These components can be used by overriding the appropriate <<>> method in a custom TilesContainerFactory.
+
+** Custom {LocaleResolver}
+
+ The default implementation is {{{./apidocs/org/apache/tiles/locale/impl/DefaultLocaleResolver.html}DefaultLocaleResolver}}.
+
+** Custom {DefinitionDAO}
+
+ The default implementation is {{{./apidocs/org/apache/tiles/definition/dao/ResolvingLocaleUrlDefinitionDAO.html}ResolvingLocaleUrlDefinitionDAO}}.
+
+** Custom {AttributeEvaluatorFactory}
+
+ The default implementation is {{{./apidocs/org/apache/tiles/evaluator/BasicAttributeEvaluatorFactory.html}BasicAttributeEvaluatorFactory}}.
+
+ It can be used with a number of AttributeEvaluators like:
+
+ * the {{{./apidocs/org/apache/tiles/evaluator/impl/DirectAttributeEvaluator.html}DirectAttributeEvaluator}},
+
+ * the {{{./apidocs/org/apache/tiles/el/ELAttributeEvaluator.html}ELAttributeEvaluator}},
+
+ * the {{{./apidocs/org/apache/tiles/mvel/MVELAttributeEvaluator.html}MVELAttributeEvaluator}},
+
+ * the {{{./apidocs/org/apache/tiles/ognl/OGNLAttributeEvaluator.html}OGNLAttributeEvaluator}}.
+
+ Please see {{{./xref/org/apache/tiles/extras/complete/CompleteAutoloadTilesContainerFactory.html}CompleteAutoloadTilesContainerFactory}}
+ for an example of how to configure those.
+
+** Custom {PreparerFactory}
+
+ The default implementation is {{{./apidocs/org/apache/tiles/preparer/factory/BasicPreparerFactory.html}BasicPreparerFactory}}.
+
+ Currently the preparer is associated to a definition using its class name.
+ There will be only <> instance per unique class name. If you want to
+ customize this behaviour, you have to create your own implementation of the
+ <<>> interface.
+
+ For example, the {{{./tutorial/integration/frameworks.html}Struts 1 - Apache Tiles\u0099 integration}}
+ defines a <<>> that can use a URL as a preparer.
+
+** Custom {PatternDefinitionResolver}
+
+ The default implementation is {{{./apidocs/org/apache/tiles/definition/pattern/BasicPatternDefinitionResolver.html}BasicPatternDefinitionResolver}},
+ that implements the syntax.
+
+ <<>> defines a <<>> to enable the use of
+ both the syntax and the syntax, with appropriate prefixes.
+
+* Registering {Renderers}
+
+ Custom {{{/tiles-request/apidocs/org/apache/tiles/request/render/Renderer.html}Renderers}} can be registered by overriding the methods
+ <<>> and <<>>.
+
+ <<>> registers 3 renderers: <<>>, <<>>, and <<>>, in order to
+ render plain strings, JSPs and tiles definitions.
+
+ <<>> registers 5 renderers: <<>>, <<>>, <<>>,
+ <<>> and <<>>, in order to render plain strings, JSPs, freemarker and velocity templates
+ and tiles definitions.
+
+* Changing the {definition files}
+
+ The default implementation <<>> loads the file named <<>>.
+
+ <<>> loads all files named <<>> in the web application, or <<>> on the classpath.
+
+ Those file names can be changed by overriding the method <<>>:
+
+-----------
+protected List getSources(ApplicationContext applicationContext) {
+ return applicationContext.getResources("/WEB-INF/my-tiles-definitions-file.xml");
+}
+-----------
+
+ Please note that when using <<>>,
+ the <<>> loads the resources via spring, and supports
+ {{{http://static.springsource.org/spring/docs/2.5.x/reference/resources.html#resources-resource-strings}the spring syntax}} for locating resources.
+
diff --git a/Java-base/tiles/src/src/site/apt/dev/release.apt b/Java-base/tiles/src/src/site/apt/dev/release.apt
new file mode 100644
index 000000000..5c5341a0c
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/dev/release.apt
@@ -0,0 +1,327 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Release Process
+ -----------
+
+Tiles Release Process
+
+ Here you will find the steps to create releases for Tiles.
+
+Prerequisites
+
+ To create a release you have to install:
+
+ * {{{http://www.oracle.com/technetwork/java/javase/overview/index.html}Java 9}}. If you are using a newer
+ version of Java <>
+ when calling Maven, so it points to an instance of Java 9;
+
+ * {{{http://maven.apache.org/}Maven 3.2.2+}};
+
+ * {{{http://www.gnupg.org/}GnuPG}};
+
+ * {{{http://www.openssh.com/}OpenSSH}};
+
+ * {{{http://www.graphviz.org/}GraphViz}};
+
+One-time operations
+
+ These operations need to be performed only one time.
+
+* Create and publish your GPG key
+
+ To create a GPG key, follow the
+ {{{http://www.apache.org/dev/openpgp.html}guidelines}}.
+ Include it in:
+
+-------------------------------------
+https://svn.apache.org/repos/asf/tiles/site/KEYS
+-------------------------------------
+
+ Publish your GPG key in a PGP key server, such as
+ {{{http://pgp.mit.edu/} MIT Keyserver}}.
+
+* Modify <<>>
+
+ Your <<>> must be modified to allow deployment.
+
+ This is the minimal configuration, obviously if you already have a <<>> file,
+ you must edit it:
+
+---------------------------
+
+
+
+ apache-site
+ YOUR_APACHE_USERNAME
+ 664
+ 775
+
+
+ apache.snapshots.https
+ YOUR_APACHE_USERNAME
+ YOUR_APACHE_PASSWORD
+
+
+ apache.releases.https
+ YOUR_APACHE_USERNAME
+ YOUR_APACHE_PASSWORD
+
+
+
+
+ release
+
+ YOUR_SECRET_PHRASE
+
+
+
+
+
+---------------------------
+
+Repeatable operations
+
+ These steps must be performed <> release.
+
+* Prepare the release tag
+
+ To prepare the release Subversion tag, check out the branch/trunk from where
+ you are preparing the release and type:
+
+-----------------------------------
+mvn release:prepare -Dusername=YOUR_SVN_USER -Dpassword=YOUR_SVN_PASSWORD
+-----------------------------------
+
+ The plugin interactively will ask you the version to release, the Subversion
+ tag to use and the next snapshot version. It is recommended to use the tag:
+ <>.
+
+ See also {{{http://www.apache.org/dev/publishing-maven-artifacts.html}the recommendations of the ASF}}.
+
+* Perform the Release
+
+ To perform the release, i.e. creating and deploying Maven artifacts, use:
+
+-----------------------------------
+mvn release:perform -Duser.name=YOUR_PEOPLE_APACHE_SSH_USER -Darguments="-Duser.name=YOUR_PEOPLE_APACHE_SSH_USER"
+-----------------------------------
+
+ It should compile and test everything, build and upload the artifacts and the website for the project.
+
+ Upload the assemblies manually with
+
+-----------------------------------
+cd target/
+svn co https://dist.apache.org/repos/dist/dev/tiles tiles-dist-dev
+mkdir tiles-dist-dev/request/${version}
+cp checkout/assembly/target/assembly/* tiles-dist-dev/${version}/
+svn add tiles-dist-dev/${version}
+svn ci tiles-dist-dev/${version}
+-----------------------------------
+
+* Close the staging repository
+
+ Login to {{{https://repository.apache.org} Nexus repository}} using your Apache LDAP credentials.
+ Click on "Staging". Then click on "tiles" in the list of repositories.
+ In the panel below you should see an open repository that is linked to your username and ip.
+ Right click on this repository and select "Close".
+ This will close the repository from future deployments and make it available for others to view.
+ If you are staging multiple releases together, skip this step until you have staged everything.
+ Enter the name and version of the artifact being released in the "Description" field and then click "Close".
+ This will make it easier to identify it later.
+
+* Verify the staged artifacts
+
+ If you click on your repository, a tree view will appear below.
+ You can then browse the contents to ensure the artifacts are as you expect them.
+ Pay particular attention to the existence of *.asc (signature) files.
+ If the you don't like the content of the repository, right click your repository and choose "Drop".
+ You can then rollback your release and repeat the process.
+
+ Note the repository URL, you will need this in your vote email.
+
+* Verify the uploaded assemblies
+
+ * go to the destination directory on people.apache.org (cd /www/people.apache.org/builds/tiles/${version}).
+
+ * check the presence of the 3 distributions (bin, doc and src), and their signature files (*.asc, *.md5, *sha1).
+
+* Release the JIRA version
+
+ * In JIRA go to the version that you want to release and release it.
+
+ * Create a new version, if it has not been done before.
+
+ * Create the release notes and <> that it uses.
+
+* Send announcement for the test build
+
+ In <> send an announcement for the test build:
+
+-----------------------------------
+Subject: [ANNOUNCE] Tiles ${version} test build available
+
+The test build of Tiles ${version} is available.
+
+
+No determination as to the quality ('alpha,' 'beta,' or 'GA') of Tiles
+${version} has been made, and at this time it is simply a "test build". We
+welcome any comments you may have, and will take all feedback into
+account if a quality vote is called for this build.
+
+Release notes:
+
+* ${jira.release.notes}
+
+Distribution:
+
+ * https://dist.apache.org/repos/dist/dev/tiles/${version}/
+
+Maven 2 staging repository:
+
+ * https://repository.apache.org/content/repositories/tiles-[YOUR REPOSITORY ID]/
+
+A vote regarding the quality of this test build will be initiated
+within the next couple of days.
+-----------------------------------
+
+* Call for a vote
+
+ A few days after the test build announcement, call for a vote in
+ <>.
+
+-----------------------------------
+Subject: [VOTE] ${version} Release Quality
+
+The Tiles ${version} test build has been available since ${testBuildDate}.
+
+Release notes:
+
+* ${jira.release.notes}
+
+Distribution:
+
+ * https://dist.apache.org/repos/dist/dev/tiles/${version}/
+
+Maven 2 staging repository:
+
+ * https://repository.apache.org/content/repositories/tiles-[YOUR REPOSITORY ID]/
+
+If you have had a chance to review the test build, please respond with
+a vote on its quality:
+
+ [ ] Leave at test build
+ [ ] Alpha
+ [ ] Beta
+ [ ] General Availability (GA)
+
+
+Everyone who has tested the build is invited to vote. Votes by PMC
+members are considered binding. A vote passes if there are at least
+three binding +1s and more +1s than -1s.
+-----------------------------------
+
+* Post-vote operations
+
+ After a vote is finished, and it has been decided that is
+ <>, there is the need of a post-vote process.
+
+** Promote staged artifacts
+
+ Once the release is deemed fit for public consumption it can be transfered to a production repository where it will be available to all users.
+
+ Login to {{{https://repository.apache.org}Nexus repository}} again.
+ Click on "Staging" and then on the repository with id "tiles-staging".
+ Find your closed staging repository, right click on it and choose "Promote".
+ Select the "Releases" repository and click "Promote".
+
+ Next click on "Repositories", select the "Releases" repository
+ and validate that your artifacts exist as you expect them.
+
+** Move assemblies
+
+ * Move assemblies to the Apache distribution mirrors:
+
+-------------------------------------------
+
+svn mv https://dist.apache.org/repos/dist/dev/tiles/${version} https://dist.apache.org/repos/dist/release/tiles/
+
+-------------------------------------------
+
+** Update the site
+
+ * Wait 24 hours to let the mirror sync to the release and then update the
+ site. In particular you have to update the index and the download pages:
+
+------------------------------------------------
+https://svn.apache.org/repos/asf/tiles/site/src/site/xdoc/index.xml
+https://svn.apache.org/repos/asf/tiles/site/src/site/apt/download.apt
+------------------------------------------------
+
+ Build and publish the site:
+
+--------------------------------------
+mvn site
+mvn site:deploy
+--------------------------------------
+
+** Send announcement
+
+ Finally, send an an announcement to the <> and <>:
+
+--------------------------------------
+Subject: [ANNOUNCE] Tiles ${version} ${quality} released
+
+The Apache Tiles team is pleased to announce the release of Tiles ${version}
+${quality}.
+
+Tiles ${version} is available in a binary and a source distribution.
+
+http://tiles.apache.org/download.html
+
+It is also available in the central Maven repository under Group ID
+"org.apache.tiles".
+
+The 3.0.x series of the Apache Tiles framework has a minimum
+requirement of the following specification versions:
+
+* Java Servlet 2.5 and JavaServer Pages (JSP) 2.1
+* Java Standard Edition (Java SE) 1.8
+
+The release notes are available online at:
+
+* ${jira.release.notes}
+
+Please feel free to test the distribution and post your comments to
+the user list, or, if appropriate, file a ticket with JIRA.
+--------------------------------------
+
+** Delete old releases
+
+ As described in http://www.apache.org/dev/release.html#when-to-archive
+
+
+
+ <>
diff --git a/Java-base/tiles/src/src/site/apt/getting_started.apt b/Java-base/tiles/src/src/site/apt/getting_started.apt
new file mode 100644
index 000000000..b1fba867d
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/getting_started.apt
@@ -0,0 +1,84 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Getting started
+ -----------
+
+Requirements
+
+ To use Tiles in your application you need:
+
+ * a Java Runtime Environment following the <> specifications;
+
+ * implementations for slf4j 1.5.8 (or above) and commons-logging 1.1 (or above);
+
+ * Optionally, depending on which options and templating engines you configure:
+
+ * a servlet container that supports <> (or above) and <> (or above).
+
+ * a portlet container that supports <> (or above).
+
+ * check {{{./dependency-management.html}Dependency management}} for a comprehensive list.
+
+Installation
+
+ Tiles 3.0 includes a large number of optional jar files and transitive dependencies. We
+ recommend that you use maven or a compatible dependency manager to retrieve only the files
+ you really need.
+
+ If however you wish to install Tiles in your application by hand:
+
+ * {{{/download.html}download}} a distribution of Tiles;
+
+ * if you downloaded the binary distribution, unpack it;
+
+ * copy all the jar files into the classpath of your application (for instance
+ in the <<>> directory of your web application). In a web environment,
+ it is <> to put them in a location where they are shared
+ across the container;
+
+Usage
+
+ If you are using Tiles for the first time, read the
+ {{{./tutorial/index.html}Tutorial}}.
+
+ If you are migrating from Struts-Tiles, see the
+ {{{./migration/index.html}Migration guide}}.
+
+ If you're an advanced user, you may find the details you're looking for in
+ the {{{./index.html}reference documentation}}.
+
+Examples
+
+ To see Tiles in action, there are two examples:
+
+ * The Tiles test web application, included in <<>> directory of the
+ binary distribution ({{{/download.html}download it}}).
+
+ * The Tiles showcase, that shows Tiles features and integration with other
+ technologies and frameworks (currently only Struts 1).
+
+ Currently it is still under development, and you can access it through its
+ subversion repository:
+
+-----------------------------
+http://svn.apache.org/repos/asf/tiles/examples/trunk/tiles-showcase/
+-----------------------------
diff --git a/Java-base/tiles/src/src/site/apt/index.apt b/Java-base/tiles/src/src/site/apt/index.apt
new file mode 100644
index 000000000..68323f7e1
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/index.apt
@@ -0,0 +1,63 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Home
+ -----------
+
+Apache Tiles\u2122
+
+
+ <<{{{http://tiles.apache.org}Apache Tiles}}>> is a template composition
+ framework. Tiles was originally built to simplify the development of web
+ application user interfaces, but it is no longer restricted to the JavaEE
+ web environment.
+
+ Tiles allows authors to define page fragments which can be assembled
+ into a complete page at runtime. These fragments, or tiles, can be used
+ as simple includes in order to reduce the duplication of common page
+ elements or embedded within other tiles to develop a series of reusable
+ templates. These templates streamline the development of a consistent
+ look and feel across an entire application.
+
+ {{{/download.html}Download Tiles}}
+
+ {{{./security/index.html}Security bulletins}}
+
+* Documentation
+
+ * {{{./whats-new.html}<>}}
+
+ * {{{./tutorial/index.html}Tutorial}}
+
+ * {{{http://cwiki.apache.org/TILES/}Wiki}}
+
+ * Reference
+
+ ** {{{./getting_started.html}Getting Started}} and installing Tiles
+
+ ** {{{./config-reference.html}Configuration Reference}}
+
+ ** {{{./apidocs/index.html}Javadocs}}
+
+ ** {{{./tiles-jsp/tlddoc/index.html}Tag library documentation}}
+
+ ** {{{./tiles-core/dtddoc/index.html}Tiles definition file documentation}}
+
+ * {{{./migration/index.html}Migration}} from previous versions
diff --git a/Java-base/tiles/src/src/site/apt/migration/apis.apt b/Java-base/tiles/src/src/site/apt/migration/apis.apt
new file mode 100644
index 000000000..e6572de2f
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/migration/apis.apt
@@ -0,0 +1,61 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Java APIs considerations
+ -----------
+
+Introduction
+
+ In this part of the migration guide we address the differences of the APIs
+ in Struts Tiles and Apache Tiles\u0099.
+
+ If you are a Tiles extension developer and you want to convert your existing
+ extension, see {{{./extension.html}Tiles extensions}} migration guide.
+
+Controllers and View Preparers
+
+ In Apache Tiles\u0099, the concept of a Tiles <<>>, i.e. an object that it is
+ invoked before rendering a definition, has been replaced with
+ <<>>.
+
+ The classes that implement the <<>> interface must now implement
+ the new <<>> interface, or extend the <<>>
+ class.
+
+Tiles <<>>
+
+ The <<>>, i.e. the Tiles-specific context in which the
+ current attribute values are stored, has been renamed to
+ <<>>.
+
+ The method <<>> returns an <>, and not an
+ <>, i.e. a simple object.
+
+ * Previous Migration Pages
+
+ ** {{{./index.html}Introduction }}
+
+ ** {{{./configuration.html}Tiles configuration files}}.
+
+ ** {{{./tags.html}Tiles JSP tags}}
+
+ * Next Migration Pages
+
+ ** {{{./extension.html}Tiles extensions}}.
diff --git a/Java-base/tiles/src/src/site/apt/migration/configuration.apt b/Java-base/tiles/src/src/site/apt/migration/configuration.apt
new file mode 100644
index 000000000..4ca41c483
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/migration/configuration.apt
@@ -0,0 +1,160 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Migrating Tiles configuration files
+ -----------
+
+{Reusing old Tiles configuration files}
+
+ With Tiles 2.1 and 2.2 it is possible to use old Struts-Tiles definition files, since
+ 1.1 version.
+
+ To use this feature it is needed to:
+
+ * include the <<>> package in the classpath;
+
+ * configure the compatibility definitions reader instance, that is able to
+ read old definition files.
+
+* Configuration
+
+ Override the
+ {{{../apidocs/org/apache/tiles/factory/BasicTilesContainerFactory.html#createDefinitionsReader(java.lang.Object,%20org.apache.tiles.TilesApplicationContext,%20org.apache.tiles.context.TilesRequestContextFactory)}createDefinitionsReader}}
+ method this way:
+
+---------------------------------------
+@Override
+protected DefinitionsReader createDefinitionsReader(Object context,
+ TilesApplicationContext applicationContext,
+ TilesRequestContextFactory contextFactory) {
+ return new CompatibilityDigesterDefinitionsReader();
+}
+---------------------------------------
+
+ You need to add a renderer for the "page" attribute type, that is in fact the "template" type.
+ So override the
+ {{{../apidocs/org/apache/tiles/factory/BasicTilesContainerFactory.html#registerAttributeRenderers(org.apache.tiles.renderer.impl.BasicRendererFactory,%20java.lang.Object,%20org.apache.tiles.TilesApplicationContext,%20org.apache.tiles.context.TilesRequestContextFactory,%20org.apache.tiles.TilesContainer,%20org.apache.tiles.evaluator.AttributeEvaluator)}registerAttributeRenderers}}
+ method.
+
+---------------------------------------
+@Override
+protected void registerAttributeRenderers(
+ BasicRendererFactory rendererFactory, Object context,
+ TilesApplicationContext applicationContext,
+ TilesRequestContextFactory contextFactory, TilesContainer container,
+ AttributeEvaluator evaluator) {
+ super.registerAttributeRenderers(rendererFactory, context,
+ applicationContext, contextFactory, container, evaluator);
+ TemplateAttributeRenderer templateRenderer = new TemplateAttributeRenderer();
+ templateRenderer.setApplicationContext(applicationContext);
+ templateRenderer.setRequestContextFactory(contextFactory);
+ templateRenderer.setEvaluator(evaluator);
+ rendererFactory.registerRenderer("page", templateRenderer);
+}
+---------------------------------------
+
+ <> Configuration with initialization parameter has been deprecated! If you
+ still want to use it, please refer to the
+ {{{../../2.1/framework/migration/configuration.html}2.1 version of this page}}.
+
+
+Tiles configuration files translation
+
+ A better, and more powerful, choice is to rewrite the definition files, to use
+ the new features of Tiles 2.1.
+
+ Most of XML elements and attributes can be translated one-to-one or
+ many-to-one without losing functionality from the 1.1-1.3 to the 2.1 DTD
+ version.
+
+* Header
+
+ The new header to be put in your Tiles definitions files is:
+
+------------------------------------------------------------
+
+------------------------------------------------------------
+
+* Definitions attributes
+
+*---------------------------------+--------------------------------+
+| <> | <> |
+*---------------------------------+--------------------------------+
+| <<<\>>> | <<<\>>> |
+| <<<\>>> | |
+*---------------------------------+--------------------------------+
+| <<>> | <<>> |
+| <<>> | |
+| <<>> | |
+*---------------------------------+--------------------------------+
+| <<>> | <<>> [1] |
+| <<>> | |
+*---------------------------------+--------------------------------+
+
+ * \[1\] The default behaviour of <<>> is to create and use a
+ single instance of the specified class. Anyway it is still possible to use a
+ URL as a preparer under a Struts 1 environment by using the
+ {{{http://svn.apache.org/repos/asf/struts/struts1/trunk/tiles2/}Struts 1 - Apache Tiles\u0099}}
+ integration module, still under development.
+
+
+* Putting and adding attributes values
+
+ The <<>> attribute type has been removed, use <<>> instead.
+
+ The rest of the conversion is in the table below.
+
+*-----------------------+-----------------------------------------------+
+| <> | <> |
+*-----------------------+-----------------------------------------------+
+| <<<\>>> | <<<\>>> |
+*-----------------------+-----------------------------------------------+
+| <<<\>>> | <<<\>>> |
+*-----------------------+-----------------------------------------------+
+| <<<\>>> | <<<\>>> [2] |
+| | <<<\>>> [3] |
+*-----------------------+-----------------------------------------------+
+| <<>> | <<>> |
+| <<>> | |
+*-----------------------+-----------------------------------------------+
+| <<>> | <<>> |
+*-----------------------+-----------------------------------------------+
+
+ * \[2\] <<<\>>> is used when it is needed to add a single
+ attribute to a list attribute.
+
+ * \[3\] <<<\>>> is used when it is needed to a list
+ attribute as an element of another list attribute.
+
+ []
+
+ * Previous Migration Pages
+
+ ** {{{./index.html}Introduction }}
+
+ * Next Migration Pages
+
+ ** {{{./tags.html}Tiles JSP tags}}
+
+ ** {{{./apis.html}Java APIs considerations}}.
+
+ ** {{{./extension.html}Tiles extensions}}.
diff --git a/Java-base/tiles/src/src/site/apt/migration/extension.apt b/Java-base/tiles/src/src/site/apt/migration/extension.apt
new file mode 100644
index 000000000..fa6a83e38
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/migration/extension.apt
@@ -0,0 +1,88 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Tiles extensions migration
+ -----------
+
+Introduction
+
+ Tiles extensions is the part of Tiles where a major effort in refactoring is
+ needed.
+
+ The internal part of Tiles changed completely, not only in classes names, but
+ also in their behaviour.
+
+Writing definitions factories
+
+ Usually, Struts-Tiles extension writing meant writing a
+ <<>> or a <<>> implementation. Here you will
+ find how to convert your definitions factory to work correctly with Apache Tiles\u0099.
+
+* Requests management
+
+ Apache Tiles\u0099 is now technology-independent, that means that Apache Tiles\u0099 is no longer
+ bound to a Servlet environment. That means for you that all references to
+ <<>> and <<>> have been removed,
+ replacing them with <<>>
+
+* Definitions factory implementation
+
+ The most common way to implement a Definitions Factory is extending the
+ <<>> class, that contains code to load definitions,
+ resolve Locale-specific definitions, etc.
+
+ If you implemented <<>>, here comes the bad news: it has been
+ <>! Getting a "key" to map different definitions factory was an
+ uncommon implementation detail. But it is easily reproducable, since you can
+ take the <<>> and calculate your "key". This key can be
+ used to map different <<>> instances, or to be given to an
+ instance of a class extending <<>>. Whatever you choose, it's
+ only a question of taste.
+
+Class and interfaces new names
+
+ The following is a conversion table between Struts-Tiles and Apache Tiles\u0099 class
+ names.
+
+*---------------------------------+---------------------------------+
+| <> | <> |
+*---------------------------------+---------------------------------+
+| <<>> | <<>> |
+*---------------------------------+---------------------------------+
+| <<>> | <<>> |
+*---------------------------------+---------------------------------+
+| <<>> | <<>> |
+*---------------------------------+---------------------------------+
+| <<>> | <<>> |
+*---------------------------------+---------------------------------+
+| <<>> | <<>> |
+*---------------------------------+---------------------------------+
+| <<>> | <<>> |
+*---------------------------------+---------------------------------+
+
+ * Previous Migration Pages
+
+ ** {{{./index.html}Introduction }}
+
+ ** {{{./configuration.html}Tiles configuration files}}.
+
+ ** {{{./tags.html}Tiles JSP tags}}
+
+ ** {{{./apis.html}Java APIs considerations}}.
diff --git a/Java-base/tiles/src/src/site/apt/migration/index.apt b/Java-base/tiles/src/src/site/apt/migration/index.apt
new file mode 100644
index 000000000..50ec11485
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/migration/index.apt
@@ -0,0 +1,57 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Migration from Struts-Tiles
+ -----------
+
+Migration from Struts-Tiles
+
+ This tutorial is intended to provide a help when migrating from the previous
+ version of Tiles, known as
+ <<{{{http://struts.apache.org/1.3.8/struts-tiles/index.html}Struts-Tiles}}>>.
+
+ To use Tiles you need to put in your web application library directory:
+
+ * <<>>: it contains the API to manipulate and render Tiles.
+
+ * <<>>: it contains the "engine" of Tiles, and the basic
+ implementation of the APIs.
+
+ * <<>>: it contains the servlet support in Tiles.
+
+ * <<>>: it contains the JSP support to Tiles, i.e. JSP specific
+ classes and the tag library.
+
+ * <<>>: it contains the compatibility layer of Tiles to
+ support Struts-Tiles 1.x XML definition files.
+
+* Further steps
+
+ * {{{./configuration.html}Tiles configuration files}}: How to migrate Tiles
+ configuration files, the file usually named <<>>.
+
+ * {{{./tags.html}Tiles JSP tags}}: How to migrate Tiles JSP tags, the
+ <<<\>>> tags.
+
+ * {{{./apis.html}Java APIs considerations}}: Some information and warnings on
+ the different behaviour of the Tiles Java API.
+
+ * {{{./extension.html}Tiles extensions}}: How to migrate Tiles
+ extensions, with explanation of main changes in the code structure.
diff --git a/Java-base/tiles/src/src/site/apt/migration/tags.apt b/Java-base/tiles/src/src/site/apt/migration/tags.apt
new file mode 100644
index 000000000..72a8915db
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/migration/tags.apt
@@ -0,0 +1,132 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Translation of JSP tags
+ -----------
+
+Introduction
+
+ Tiles JSP tag library changed a lot, to be clearer and simpler than it was
+ before. This means that you need to change ALL of your JSP pages accordingly.
+
+Tag library inclusion
+
+ To include Tiles tag library, write this row on top of your JSP files:
+
+---------------------------------------------------------------------
+<%@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="tiles" %>
+---------------------------------------------------------------------
+
+Tags differences
+
+ Here is the toughest part: Apache Tiles\u0099 tags differ a lot comparing to Struts
+ Tiles. However, after the change you will notice that the JSP code will be
+ easier to understand.
+
+* The <<<\>>> tag replacement
+
+ The <<<\>>> of Struts-Tiles changed, in the sense that it has
+ been split in different parts and many attributes have been removed. The
+ changes are summarized in the table below.
+
+*---------------------------------+----------------------------------+
+| <> | <> |
+*---------------------------------+----------------------------------+
+| <<<\>>> | <<<\>>> |
+| | <<<\>>> |
+| | <<<\>>> |
+*---------------------------------+----------------------------------+
+| <<>> | Use <<<\>>> |
+*---------------------------------+----------------------------------+
+| <<>> | Use <<<\>>> |
+*---------------------------------+----------------------------------+
+| <<>> | <<>> |
+| <<>> | |
+*---------------------------------+----------------------------------+
+| <<>> | <<>> |
+| <<>> | |
+| <<>> | |
+*---------------------------------+----------------------------------+
+| <<>> | <<>> [1] |
+| <<>> | |
+*---------------------------------+----------------------------------+
+
+
+ * \[1\] The default behaviour of <<>> is to create and use a
+ single instance of the specified class. Anyway it is still possible to use a
+ URL as a preparer under a Struts 1 environment by using the
+ {{{http://svn.apache.org/repos/asf/struts/struts1/trunk/tiles2/}Struts 1 - Apache Tiles\u0099}}
+ integration module, still under development.
+
+* Putting and adding attributes values
+
+ The <<>> attribute type has been removed, use <<>> instead.
+
+ The rest of the conversion is in the table below.
+
+*-------------------------+-----------------------------------------------+
+| <> | <> |
+*-------------------------+-----------------------------------------------+
+| <<<\>>> | <<<\>>> |
+*-------------------------+-----------------------------------------------+
+| <<<\>>> | <<<\>>> |
+*-------------------------+-----------------------------------------------+
+| <<<\>>> | <<<\>>> [2] |
+| | <<<\>>> [3] |
+*-------------------------+-----------------------------------------------+
+| <<>> | <<>> |
+| <<>> | |
+*-------------------------+-----------------------------------------------+
+| <<>> | <<>> |
+*-------------------------+-----------------------------------------------+
+| <<>> | <<>> |
+| <<>> | |
+| <<>> | |
+*---------------------------------+----------------------------------+
+
+ * \[2\] <<<\>>> is used when it is needed to add a single
+ attribute to a list attribute.
+
+ * \[3\] <<<\>>> is used when it is needed to a list
+ attribute as an element of another list attribute.
+
+* Other changes
+
+*---------------------------------+--------------------------------------------+
+| <> | <> |
+*---------------------------------+--------------------------------------------+
+| <<<\>>> | <<<\>>> |
+*---------------------------------+--------------------------------------------+
+| <<<\>>> | Removed, definitions are created in request scope. |
+*---------------------------------+--------------------------------------------+
+| <<<\>>> | <<<\>>> |
+*---------------------------------+--------------------------------------------+
+
+ * Previous Migration Pages
+
+ ** {{{./index.html}Introduction }}
+
+ ** {{{./configuration.html}Tiles configuration files}}.
+
+ * Next Migration Pages
+
+ ** {{{./apis.html}Java APIs considerations}}.
+
+ ** {{{./extension.html}Tiles extensions}}.
diff --git a/Java-base/tiles/src/src/site/apt/security/index.apt b/Java-base/tiles/src/src/site/apt/security/index.apt
new file mode 100644
index 000000000..5de299406
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/security/index.apt
@@ -0,0 +1,28 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Security bulletins
+ -----------
+
+Security bulletins
+
+ Here are collected all security bulletins about Tiles.
+
+ * {{{./security-bulletin-1.html}Security Bulletin 1}}.
diff --git a/Java-base/tiles/src/src/site/apt/security/security-bulletin-1.apt b/Java-base/tiles/src/src/site/apt/security/security-bulletin-1.apt
new file mode 100644
index 000000000..8d5d6a174
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/security/security-bulletin-1.apt
@@ -0,0 +1,72 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Security bulletin 1
+ -----------
+
+Security bulletin 1
+
+* Summary
+
+ EL expressions in JSP using some Tiles JSP tags are evaluated twice.
+
+*-------------------------+-----------+
+| Who should read this | All Tiles 2.1 developers |
+*-------------------------+-----------+
+| Impact of vulnerability | Remote server context exposure |
+*-------------------------+-----------+
+| Maximum security rating | High (read-only exposure) |
+*-------------------------+-----------+
+| Recommendation | Developers should not install Tiles 2.1.1 under a production environment, |
+| | upgrade to Tiles 2.1.2 |
+*-------------------------+-----------+
+| Affected Software | Tiles 2.1.0/2.1.1 (Tiles 2.0.x versions are safe) |
+*-------------------------+-----------+
+| Original JIRA Ticket | {{{https://issues.apache.org/jira/browse/TILES-351}TILES-351}} |
+*-------------------------+-----------+
+| Reporter | Antonio Petrelli (Tiles PMC member) |
+*-------------------------+-----------+
+
+* Problem
+
+ Tiles 2.1.x allows, with the
+ {{{../tutorial/advanced/el-support.html}correct configuration}},
+ to use EL expressions in Tiles configuration files.
+
+ The problem is that, if attribute values or templates are defined using
+ some JSP tags (tiles:putAttribute, tiles:insertTemplate), the EL expression
+ is evaluated twice, one by the container, one by the ELAttributeEvaluator
+ class.
+
+ Now, if at the first evaluation the EL expression is connected to a
+ user-entered content, it could be maliciously exploited to access the
+ server context.
+
+ Therefore, there could be an unwanted exposure of server data or XSS attacks.
+
+* Solution
+
+ The API and the core have been modified to separate the expression evaluation
+ from the attribute/template manipulation made by JSP tags in a safe way.
+
+ Since Tiles 2.1.1 is still in beta, the recommendation is not to install it
+ in a production environment. A release, in this case, is not necessary.
+ Experimenter can download the latest version of Tiles from the
+ {{{http://svn.apache.org/repos/asf/tiles/framework/trunk/}SVN repository}}.
diff --git a/Java-base/tiles/src/src/site/apt/selenium.apt b/Java-base/tiles/src/src/site/apt/selenium.apt
new file mode 100755
index 000000000..4be3bd5e3
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/selenium.apt
@@ -0,0 +1,166 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Selenium Testing
+ -----------
+
+Selenium Testing
+
+ <<{{{http://selenium.openqa.org}Selenium}}>> is a test tool for web
+ applications. Unlike HtmlUnit or HttpUnit tests which a browser,
+ Selenium tests run directly in a real browser such as Firefox or Internet
+ Explorer. The Selenium JavaScript code is deployed alongside your running
+ application, and interacts with it just as your users do.
+
+ Apache Tiles\u0099 uses Selenium for functional testing of the example apps.
+ The following example apps include Selenium tests:
+
+ * Tiles Test
+
+* Install
+
+ Selenium is available in OpenQA's Maven repository, so no installation is
+ necessary.
+
+ However, you may want to download the Selenium distribution (which includes
+ the documentation) from
+ {{{http://www.openqa.org/selenium-core/download.action}
+ http://www.openqa.org/selenium-core/download.action}}.
+
+ While you're there, also install the Firefox plugin <> from
+ {{{http://www.openqa.org/selenium-ide/}
+ http://www.openqa.org/selenium-ide/}}.
+
+* Run Selenium tests the easy way
+
+ To run Selenium tests you need to add a configuration parameter in your <<>> file.
+
+------------------------------
+
+...
+
+ ...
+
+ run-selenium
+
+ /tomcat/installation/directory
+
+
+ ...
+
+
+------------------------------
+
+ After that, if you have Firefox installed, you can launch Selenium tests in the command line:
+
+------------------------------
+mvn verity -Prun-selenium
+------------------------------
+
+* Package
+
+ <> the webapp with the 'selenium' profile activated.
+
+ The {{{http://svn.apache.org/viewvc/struts/sandbox/trunk/tiles/tiles-test/pom.xml
+?view=markup}tiles-test pom}} includes a 'selenium' profile that will
+
+ * unpack the Selenium jar under 'target'
+
+ * copy the 'core' directory from the unpacked Selenium jar into the
+ webapp
+
+ * copy any files in 'src/test/selenium' into the webapp
+
+ []
+
++-----+
+mvn package -P selenium
++-----+
+
+ The webapp will contain the following additional directories: 'selenium/core'
+ and 'selenium/tests'.
+
+* Deploy
+
+ <> the webapp to your favorite container. The Cargo plugin is
+ configured to make this easy:
+
++-----+
+mvn package cargo:start -P selenium
+
+ or
+
+mvn package cargo:start -P selenium -Dcargo.tomcat5x.home=/path/to/tomcat5
++-----+
+
+
+* Run
+
+ <> the tests with the Selenium TestRunner.
+
+ * Visit <</selenium/core/TestRunner.html>>>
+
+ * Click 'go' in the top left frame to load the TestSuite.html page
+
+ * Click 'All' in the top right frame to run the tests
+
+ []
+
+ <> the tests .
+
+ * Check the 'Auto-run' box before clicking 'go' in the top left frame.
+
+ []
+
+ After it runs the tests automatically, Selenium can <<>> the results to
+ a URL you supply. If you accept the default, and nothing is there to process
+ the request, you will see a 404 Not Found error page in the bottom frame.
+
+
+* Edit
+
+ <> an existing test, or write a new one.
+
+ If you add a new test, remember to add it to src/test/selenium/TestSuite.html
+ so the TestRunner will find it.
+
+** Selenium IDE
+
+ The Selenium IDE Firefox plugin is the easiest way to edit tests. With the
+ example app running, open the HTML file (src/test/selenium/TestSomething.html)
+ from your svn checkout of Apache Tiles\u0099. Use the IDE to edit and run the test, and
+ save your changes.
+
+ <>: Your changes will not be visible to the TestRunner in the deployed
+ webapp unless you re-package and deploy it.
+
+** HTML Editor
+
+ Selenium tests are written in plain HTML tables, so you may edit them with any
+ text editor.
+
+ If you prefer to edit the tests 'in place' in the running webapp, simply copy
+ the files back to your svn checkout directory and commit the changes (or submit
+ a patch).
+
+
diff --git a/Java-base/tiles/src/src/site/apt/tutorial/advanced/attribute-rendering.apt b/Java-base/tiles/src/src/site/apt/tutorial/advanced/attribute-rendering.apt
new file mode 100644
index 000000000..97a53955f
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/tutorial/advanced/attribute-rendering.apt
@@ -0,0 +1,82 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Attribute rendering
+ -----------
+
+Attribute rendering
+
+ Attribute rendering behaviour can be customized. The "type"
+ of an attribute can be still <<>>, <<>> or <<>>
+ but you can define new types or use a class name directly.
+
+Default behaviour
+
+ The default behaviour of Tiles is compatible with Tiles 2.0 and it applies
+ both to XML definition files and JSP tags. Tiles follows these steps:
+
+ * If the type is not specified:
+
+ ** if the value is a valid definition name, the definition is rendered;
+
+ ** if the value starts with a '/', a template will be rendered;
+
+ ** otherwise, a string will be rendered.
+
+ * If the type is specified:
+
+ ** if the type is <<>>, <<>> or <<>>, it will
+ be rendered like in Tiles 2.0;
+
+ ** otherwise, Tiles tries to instantiate (only once) a class whose name is
+ specified in the "type" of the attribute. If an error occurs, it pops up as
+ a runtime exception.
+
+Customize attribute rendering
+
+ With Tiles 2.1+ you can customize rendering in three ways:
+
+ * specifying new renderers;
+
+ * overriding the default renderer for untyped attributes;
+
+ * specifying a new renderer factory.
+
+* Custom attribute renderers
+
+ If you don't want to use class names as attribute types, you can use new
+ "named" custom attribute renderers. You can do it by overriding the
+ {{{../../apidocs/org/apache/tiles/factory/BasicTilesContainerFactory.html#method_summary}registerAttributeRenderers}}
+ of <<>> if you are using Java-based configuration.
+
+* Custom default attribute renderer
+
+ The behaviour of Tiles when the type of an attribute is not specified can also be
+ customized. You can do it by overriding the
+ {{{../../apidocs/org/apache/tiles/factory/BasicTilesContainerFactory.html#method_summary}createDefaultAttributeRenderer}}
+ of <<>> if you are using Java-based configuration.
+
+* Custom attribute renderer factory
+
+ The attribute renderer factory can be completely customized, leaving to you
+ the maximum freedom of choice in the attribute renderer creation. You can
+ specify the factory's implementation by overriding the
+ {{{../../apidocs/org/apache/tiles/factory/BasicTilesContainerFactory.html#method_summary}createRendererFactory}}
+ of <<>> if you are using Java-based configuration.
diff --git a/Java-base/tiles/src/src/site/apt/tutorial/advanced/el-support.apt b/Java-base/tiles/src/src/site/apt/tutorial/advanced/el-support.apt
new file mode 100644
index 000000000..ec728de04
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/tutorial/advanced/el-support.apt
@@ -0,0 +1,98 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Expression Language (EL) support
+ -----------
+
+Expression Language support
+
+ With Tiles it is possible to use expression languages not only in JSP pages, but also in XML
+ definition files.
+
+ Currently supported languages are Unified EL (as in javax.el), i.e. the language used in JSP code,
+ {{{http://mvel.codehaus.org/}MVEL}} and {{{http://commons.apache.org/ognl/}OGNL}}.
+
+* Configuration
+
+ By default, Tiles does not use an expression language, attribute values are simply used as they are.
+
+ <<>> enables support of Unified EL, MVEL and OGNL as follows:
+
+ - an attribute expression starting with "MVEL:" or "OGNL:" is interpreted in one of those languages.
+ - otherwise, the parts of the expression between the braces in <<<$\{...\}>>> are interpreted in Unified EL.
+
+* Unified EL support
+
+ The EL language is supported since Tiles 2.1.
+
+ Let's use this example:
+
+------------------------------------
+
+
+
+
+
+------------------------------------
+
+ Before rendering the definition:
+
+ * The template name will be taken from the "layout" attribute, searched in every scope.
+
+ * The body will be taken from the "body" attribute in request scope.
+
+* {MVEL Support}
+
+ Let's use this example:
+
+------------------------------------
+
+
+
+
+
+------------------------------------
+
+ Before rendering the definition:
+
+ * The template name will be taken from the "layout" attribute, searched in every scope.
+
+ * The body will be taken from the "body" attribute in request scope.
+
+* {OGNL Support}
+
+ Let's use this example:
+
+------------------------------------
+
+
+
+
+
+------------------------------------
+
+ Before rendering the definition:
+
+ * The template name will be taken from the "layout" attribute, searched in every scope.
+
+ * The body will be taken from the "body" attribute in request scope.
diff --git a/Java-base/tiles/src/src/site/apt/tutorial/advanced/index.apt b/Java-base/tiles/src/src/site/apt/tutorial/advanced/index.apt
new file mode 100644
index 000000000..2f98cbe76
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/tutorial/advanced/index.apt
@@ -0,0 +1,50 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Tiles Advanced Topics
+ -----------
+
+Tiles Advanced Topics
+
+ In this section, advanced usage of Tiles is discussed. These topics let you
+ do more complicated tasks, like composing pages one inside another, localize
+ your pages, etc.
+
+ [[1]] {{{./nesting-extending.html}Nesting and Extending Definitions}}
+
+ [[2]] {{{./list-attributes.html}List Attributes}}
+
+ [[3]] {{{./runtime.html}Runtime Composition}}
+
+ [[4]] {{{./preparer.html}View Preparers}}
+
+ [[5]] {{{./utils.html}Rendering Utilities}}
+
+ [[6]] {{{./l10n.html}Tiles Localization}}
+
+ [[7]] {{{./wildcard.html}Wildcard support}}
+
+ [[8]] {{{./el-support.html}EL support}}
+
+ [[9]] {{{./attribute-rendering.html}Attribute rendering}}
+
+ [[10]] {{{./multiple-containers.html}Using multiple containers}}
+
+ [[11]] {{{./security.html}Security}}
diff --git a/Java-base/tiles/src/src/site/apt/tutorial/advanced/l10n.apt b/Java-base/tiles/src/src/site/apt/tutorial/advanced/l10n.apt
new file mode 100644
index 000000000..80db80b87
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/tutorial/advanced/l10n.apt
@@ -0,0 +1,135 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Tiles Localization
+ -----------
+
+Localization support
+
+ Customizing pages for different locales in a common practice: in real-world
+ websites you can see different sites for different languages and countries.
+
+ It can be a matter of changing the layout (for example, in Arab countries the
+ menu should stay on the right, instead of the left), or providing alternate
+ content.
+
+* Creating localized definitions
+
+ Localization is immediately available. To use the benefits of localization you
+ have to create different Tiles definition files for each locale you want to
+ support: it's simply a matter of appending the locale code at the end of the
+ file name (just like <<<.properties>>> files in resource bundles).
+
+ For example, if you have the <<>> file and you want to support
+ French and Italian locale, you have to create at least three files:
+
+--------------------------------
+tiles.xml
+tiles_fr.xml
+tiles_it.xml
+--------------------------------
+
+ You can also distinguish between different languages in different country. So
+ if you want to distinguish between British English and American English, you
+ can create these files:
+
+--------------------------------
+tiles_en_GB.xml
+tiles_en_US.xml
+--------------------------------
+
+ and so on.
+
+* Inheritance between localizations
+
+ If you want to support different locales, you don't have to rewrite all the
+ definitions, but only those that differ from the main definitions file. In
+ other words, locale-specific definition files contains the "overrides" to the
+ default definitions.
+
+ For example, suppose that the following definition is declared in
+ <<>>:
+
+------------------------------------
+
+
+
+
+
+
+
+
+
+
+
+
+
+------------------------------------
+
+ In <<>> there is a new declaration of <<>>
+ definition:
+
+------------------------------------
+
+
+
+
+
+
+
+------------------------------------
+
+ Using "it" locale, the title will be different from the default, while the
+ rest remains the same.
+
+ Notice that the <<>> definition is the one defined in
+ the default definitions file: you still can reference to the default
+ definitions, both when composing and when extending.
+
+ You can also override a <>. In this case, when
+ resolving inheritance, the overridden definition will be taken as a basis.
+ For example, if in <<>> there are the following definitions:
+
+------------------------------------
+
+
+
+
+
+
+
+
+
+
+------------------------------------
+
+ If in <<>> you define the following definition:
+
+------------------------------------
+
+
+
+
+
+------------------------------------
+
+ The <<>> will extend the latter definition, and not the default!
+ This is useful if you want to change an abstract definition for a locale,
+ without redefining all the definitions.
diff --git a/Java-base/tiles/src/src/site/apt/tutorial/advanced/list-attributes.apt b/Java-base/tiles/src/src/site/apt/tutorial/advanced/list-attributes.apt
new file mode 100644
index 000000000..a6a58e83f
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/tutorial/advanced/list-attributes.apt
@@ -0,0 +1,96 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ List Attributes
+ -----------
+
+List Attributes
+
+ Up to now we have seen simple attributes, i.e. attributes that have a simple
+ value: a template, a string or a definition. But there are cases where you
+ need a of values, for example a list of definitions to be
+ redendered one below the other.
+
+* Simple usage
+
+ To include a list attribute you can use the <<<\>>> tag
+ in your Tiles definitions file:
+
+---------------------------------------
+
+
+
+
+
+
+
+---------------------------------------
+
+ In your template page, you can read the list attribute iterating over its
+ elements:
+
+---------------------------------------
+<%@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="tiles" %>
+<%@ taglib uri="http://tiles.apache.org/tags-tiles-extras" prefix="tilesx" %>
+<%@ taglib uri="http://java.sun.com/jstl/core_rt" prefix="c" %>
+
+
+
+
+
+---------------------------------------
+
+ The list attribute is first converted into a scripting variable; after that
+ it is iterated using the <<<\>>> tag. The compound attributes are
+ then rendered one after the other.
+
+* {List attribute inheritance}
+
+ When you extend a definition that contains a list attribute, you can
+ "inherit" its elements. For example:
+
+---------------------------------------
+
+
+
+
+
+
+
+
+
+
+
+
+
+---------------------------------------
+
+ In this case, the <<>> has the <<>>
+ attribute that inherits the content of the <<>> attribute of its
+ parent definition. In other words, the <<>> attribute will container
+ the following elements:
+
+ * /tiles/banner.jsp
+
+ * /tiles/common_menu.jsp
+
+ * /tiles/credits.jsp
+
+ * /tiles/greetings.jsp
diff --git a/Java-base/tiles/src/src/site/apt/tutorial/advanced/multiple-containers.apt b/Java-base/tiles/src/src/site/apt/tutorial/advanced/multiple-containers.apt
new file mode 100644
index 000000000..84b93aaf8
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/tutorial/advanced/multiple-containers.apt
@@ -0,0 +1,86 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Using multiple containers
+ -----------
+
+Defining multiple containers
+
+ It is possible to use more that one Tiles container in your application.
+
+* Configuration
+
+ To use an alternate container, you need to override the
+ {{{../../apidocs/org/apache/tiles/startup/AbstractTilesInitializer.html#method_summary}getContainerKey}}
+ method of <<>> this way:
+
+------------------------------------
+public class TestAlternateTilesListener extends AbstractTilesListener {
+
+ /** {@inheritDoc} */
+ @Override
+ protected TilesInitializer createTilesInitializer() {
+ return new TestAlternateTilesInitializer();
+ }
+
+ /**
+ * Test Tiles initializer for Tiles initialization of the alternate container.
+ */
+ private static class TestAlternateTilesInitializer extends AbstractTilesInitializer {
+
+ // Other customizations go here.
+
+ /** {@inheritDoc} */
+ @Override
+ protected String getContainerKey(
+ TilesApplicationContext applicationContext) {
+ return "myContainerKey";
+ }
+ }
+}
+------------------------------------
+
+Selecting one non-default container
+
+ Once defined, it is possible to select a non-default container through Java
+ or JSP
+
+* Selection through Java
+
+ It is possible to use, for the current request, a different container
+ stored under another key, by using
+ {{{../../apidocs/org/apache/tiles/access/TilesAccess.html#method_summary}<<>>}}
+ method of TilesAccess class. For example:
+
+------------------------------------
+TilesAccess.setCurrentContainer(request, applicationContext, "myContainerKey");
+------------------------------------
+
+ If the last parameter is <<>>, the default container is selected.
+
+* Selection through JSP
+
+ The current container can be selected also through the use of JSP:
+
+------------------------------------
+
+------------------------------------
+
+ If the <<>> attribute is not present, the default container is selected.
diff --git a/Java-base/tiles/src/src/site/apt/tutorial/advanced/nesting-extending.apt b/Java-base/tiles/src/src/site/apt/tutorial/advanced/nesting-extending.apt
new file mode 100644
index 000000000..531e298d4
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/tutorial/advanced/nesting-extending.apt
@@ -0,0 +1,168 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Nesting and Extending Definitions
+ -----------
+
+Nesting Definitions
+
+ Sometimes it is useful to have a structured page with, say, a structured body.
+ Typically, there is a main layout (for example, the "classic" layout) and the
+ body is made of certain number of sections. In this case, nesting a definition
+ (the one for the body) inside another definition (the main layout) can be
+ useful.
+
+* {Named subdefinitions}
+
+ Tiles supports nesting definitions natively. One way of using nested definitions
+ is creating a named "subdefinition" and using it as an attribute. For example:
+
+------------------------------------
+
+
+
+
+
+
+
+
+
+
+
+
+
+------------------------------------
+
+ The <<>> definition will be put inside the
+ <<>>, by putting it inside its <<>> attribute. You will
+ be seeing the definition one inside the other.
+
+* {Anonymous nested definitions}
+
+ What you can do with named subdefinitions can be done with nested anonymous
+ definitions. The above example can be rewritten in:
+
+------------------------------------
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+------------------------------------
+
+ The anonymous definition put under the "body" attribute can be used only by
+ the surrounding definition. Moreover, you can nest a definition into a nested
+ definition, with the desired level of depth.
+
+* {Cascaded attributes}
+
+ Attributes defined into a definition can be cascaded to be available to all
+ nested definitions and templates. For example the
+ {{{./nesting-extending.html#Named_subdefinitions}sample definition}} detailed above can be rewritten
+ this way:
+
+------------------------------------
+
+
+
+
+
+
+
+
+
+
+
+------------------------------------
+
+ The template of <<>> definitionhas been used as the
+ <<>> attribute in the <<>> definition. All of the
+ attributes of <<>> has been then moved as attributes
+ of <<>> definition, but with the addition of the "cascade"
+ flag.
+
+Extending Definitions
+
+ You can extend definitions like a Java class. The concepts of , and are available.
+
+ * <>: it is a definition in which the template attributes
+ are not completely filled. They are useful to create a base page and a number
+ of extending definitions, reusing already created layout. For example:
+
+------------------------------------
+
+
+
+
+
+------------------------------------
+
+ * <>: a definition can inherit from another definition,
+ to reuse an already made (abstract or not) definition:
+
+------------------------------------
+
+
+
+
+------------------------------------
+
+ In this case, the <<>>, <<
+---------------------------------
+
+ * in JSP pages, when inserting attributes:
+
+---------------------------------
+
+---------------------------------
+
+ * in JSP pages, when putting attributes:
+
+---------------------------------
+
+---------------------------------
+
+* Allowing templates
+
+ Templates can be allowed to be rendered only by selected rows in JSP pages:
+
+---------------------------------
+
+ ...
+
+---------------------------------
diff --git a/Java-base/tiles/src/src/site/apt/tutorial/advanced/utils.apt b/Java-base/tiles/src/src/site/apt/tutorial/advanced/utils.apt
new file mode 100644
index 000000000..3d3b2445a
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/tutorial/advanced/utils.apt
@@ -0,0 +1,82 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Rendering Utilities
+ -----------
+
+Tiles Rendering Utilities
+
+ The core package of Tiles contains utilities to render Tiles definitions
+ without the need of a JSP page or a supporting framework.
+
+* <<>>
+
+ The <<>> is a servlet that intercepts the URLs ending
+ with "<<<.tiles>>>" and render the definition whose name is the path name
+ before the "<<<.tiles>>>" part.
+
+ For example, if you call the <<>> path, the
+ rendered definition will be <<>>.
+
+ You can configure the <<>> this way:
+
+------------------------------------
+
+ Tiles Dispatch Servlet
+ org.apache.tiles.web.util.TilesDispatchServlet
+
+...
+
+ Tiles Dispatch Servlet
+ *.tiles
+
+------------------------------------
+
+ By using the <<>>
+ you can use a different container. The value of this parameter will be used
+ as the key under which the container is stored.
+
+* <<>>
+
+ You can use the <<>> to use Tiles as a
+ framework. All the requests intercepted by the filter will be put inside the
+ configured attribute of the configured definition, and then that definition is
+ rendered.
+
+ You can configure the filter this way:
+
+------------------------------------
+
+ Tiles Decoration Filter
+ org.apache.tiles.web.util.TilesDecorationFilter
+
+ definition
+ test.definition
+
+
+ attribute-name
+ body
+
+
+------------------------------------
+
+ By using the <<>>
+ you can use a different container. The value of this parameter will be used
+ as the key under which the container is stored.
diff --git a/Java-base/tiles/src/src/site/apt/tutorial/advanced/wildcard.apt b/Java-base/tiles/src/src/site/apt/tutorial/advanced/wildcard.apt
new file mode 100644
index 000000000..6a716b0c2
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/tutorial/advanced/wildcard.apt
@@ -0,0 +1,169 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Wildcard support
+ -----------
+
+Wildcard support
+
+ By default, Tiles supports wildcards in definition names. Wilcards help a
+ lot in writing less code to declare your definitions.
+
+* Default configuration
+
+ Note: default configuration only works if you do not use <<>>. If you are using this setting, you can move to the next section.
+
+ Let us start with a simple example. When not using wildcards, you might end up with such tiles definitions:
+
+-----------------------------------
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+------------------------------------
+
+ The above definitions are pretty verbose as you need to create one definition per JSP that you're adding to your application.
+ You could use definition inheritance to reduce the number of lines but you would still need one definition per JSP.
+
+
+** Single star '\*'
+
+ Let's see how to improve that using wildcards. You would then have:
+
+------------------------------------
+
+
+
+
+
+------------------------------------
+ Calling a view named "bank/user" matches the above definition name. Inside the "body" attributes, \{1\} refers to the star's value which is "user" in that case.
+
+
+** Multiple stars such as in '\*/\*'
+
+ Let's now consider another case. As you can see, the sample below uses 2 stars '\*'.
+
+------------------------------------
+
+
+
+
+
+------------------------------------
+
+ Calling a view named "/bank/customer/account" matches the above definition name.
+ Inside the 'body' attribute, \{1\} refers to the first star and \{2\} refers to the second one.
+ The "body" JSP name will be "customer-account.jsp".
+
+ Here is another example which shows that you can use package-style definition names:
+
+------------------------------------
+
+
+
+
+
+------------------------------------
+
+
+* Using prefixes
+
+** Enabling CompleteAutoloadTilesContainerFactory
+
+ As a prerequisite for using prefixes, you need to have CompleteAutoloadTilesContainerFactory enabled.
+
+ If you haven't enabled it yet, here is a quick checklist for you to use.
+
+ The library tiles-extras is required. If you're using Maven, you need to add this dependency to you POM file:
+
+
+------------------------------------
+
+ org.apache.tiles
+ tiles-extras
+ 3.0.1
+
+------------------------------------
+
+ If you are using Spring, you should add the 'completeAutoload' attribute to your TilesConfigurer bean.
+
+------------------------------------
+
+
+
+------------------------------------
+
+** Using prefixes
+
+ Here is an example of prefix using Regular Expressions:
+
+------------------------------------
+
+
+
+
+
+------------------------------------
+
+ The below sample uses WILDCARD (this prefix is not needed when using wildcards solely, as shown in the 'Default Configuration' section).
+
+------------------------------------
+
+
+
+
+
+
+
+
+
+
+------------------------------------
+
+
+* tiles:insertDefinition
+
+ In both cases, if you insert a definition that matches the definition, for example:
+
+------------------------------------
+
+------------------------------------
+
+ The definition is automatically mapped, replacing placeholders, marked by
+ curly brackets, with the value of matched definitions. In this case:
+
+------------------------------------
+
+
+
+
+
+------------------------------------
\ No newline at end of file
diff --git a/Java-base/tiles/src/src/site/apt/tutorial/basic/concepts.apt b/Java-base/tiles/src/src/site/apt/tutorial/basic/concepts.apt
new file mode 100644
index 000000000..654d61eed
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/tutorial/basic/concepts.apt
@@ -0,0 +1,123 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Tiles Concepts
+ -----------
+
+Tiles concepts
+
+ Tiles is an implementation of the {{{../pattern.html}Composite View pattern}}.
+ Tiles adds to this pattern its own concepts to make the pattern concrete. The
+ implementation of Tiles around the pattern consists of the
+ {{{./concepts.html#Template}Template}}, {{{./concepts.html#Attribute}Attribute}}
+ and {{{./concepts.html#Definition}Definition}} concepts. The
+ pattern is implemented by the {{{./concepts.html#View Preparer}View Preparer}}
+ concept.
+
+* {Template}
+
+ In Tiles, a <> is the layout part of a page. You can see as a page
+ structure with some gaps, called <>, to be filled.
+
+ For instance, consider the "classic layout" page structure.
+
+[../../images/tiled_page.png] The "classic layout", a typical structure of a web
+page.
+
+ You can replicate this structure by creating a JSP page, as you can see below.
+
+-------------------------------
+<%@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="tiles" %>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+-------------------------------
+
+ Notice that a template <>: in this case it can be used
+ directly.
+
+* {Attribute}
+
+ An <> is a gap in a template that needs to be filled in your
+ application. An attribute can be of three types:
+
+ * <>: it is a string to be directly rendered as it is.
+
+ * <>: it is a template, with or without attributes. If it has
+ attributes, you have to fill them too to render a page.
+
+ * <>: it is a reusable composed page, with all (or some)
+ attributes filled (see below).
+
+* {Definition}
+
+ A <> is a composition to be rendered to the end user; essentially
+ a definition is composed of a <> and completely or partially
+ <>.
+
+ * If <> of its attributes are filled, it can be rendered to the end user.
+
+ * If <> of its attributes are filled, it is called an <>, and it can be used as a base definition for extended
+ definitions, or their missing attributes can be filled at runtime.
+
+ []
+
+ For example, you can create a page using the as seen before,
+ by modifying the {{{./pages.html}Tiles configuration file}}.
+
+------------------------------------
+
+
+
+
+
+
+------------------------------------
+
+* {View Preparer}
+
+ Sometimes a definition, before it is rendered, needs to be "prepared". For
+ example when showing a menu, the menu structure must be created and stored
+ in the request scope.
+
+ For this reason, a <> can be used: it is called <> the
+ definition is rendered, so all the things needed to render correctly the
+ definition can be prepared.
+
+ See the {{{../advanced/preparer.html}Tiles View Preparer configuration}} for
+ more information.
diff --git a/Java-base/tiles/src/src/site/apt/tutorial/basic/index.apt b/Java-base/tiles/src/src/site/apt/tutorial/basic/index.apt
new file mode 100644
index 000000000..b8a4e919a
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/tutorial/basic/index.apt
@@ -0,0 +1,32 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Tiles Basic Usage
+ -----------
+
+Tiles Basic Usage
+
+ In this part of the tutorial, you will learn the basics of Tiles and its
+ simple usage in the most common cases.
+
+ * {{{./concepts.html}Tiles concepts}}.
+
+ * {{{./pages.html}Building Tiles-enabled pages}}.
+
diff --git a/Java-base/tiles/src/src/site/apt/tutorial/basic/pages.apt b/Java-base/tiles/src/src/site/apt/tutorial/basic/pages.apt
new file mode 100644
index 000000000..6afc4c8cd
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/tutorial/basic/pages.apt
@@ -0,0 +1,134 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Creating Tiles Pages
+ -----------
+
+Creating and using Tiles pages
+
+ After installing and learning some of Tiles concepts, it is time to create
+ some pages. Here you will find the steps to create reusable Tiles pieces and
+ complete pages.
+
+* Create a template
+
+ Let's take the <> page structure:
+
+[../../images/tiled_page.png] The "classic layout", a typical structure of a web
+page.
+
+ Create a JSP page that acts as this layout and place it under
+ <<>> file.
+
+-------------------------------
+<%@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="tiles" %>
+
+
+ <tiles:getAsString name="title"/>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+-------------------------------
+
+ This template has five attributes: <<>> (of <<<string>>> type),
+ <<<header>>>, <<<menu>>>, <<<body>>> and <<<footer>>>.
+
+* Create the composing pages
+
+ In this phase, you have to create four JSP pages, that will take place of
+ <<<header>>>, <<<menu>>>, <<<body>>> and <<<footer>>> attributes in the
+ previously created template.
+
+ You can put everything you want in this pages, they are just a test.
+
+* Create a definition
+
+ By default, the definition file is <<</WEB-INF/tiles.xml>>>. If you're using <<<CompleteAutoloadTilesListener>>>,
+ tiles will use any file in the webapp that matches <<</WEB-INF/tiles*.xml>>> or any file in the classpath that matches
+ <<</META-INF/tiles*.xml>>>; if several are found, it will merge them together.
+
+ But for now, let's stick to the default and create the <<</WEB-INF/tiles.xml>>> file, with a definition
+ as described in {{{./concepts.html}concepts}}:
+
+------------------------------------
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE tiles-definitions PUBLIC
+ "-//Apache Software Foundation//DTD Tiles Configuration 3.0//EN"
+ "http://tiles.apache.org/dtds/tiles-config_3_0.dtd">
+<tiles-definitions>
+ <definition name="myapp.homepage" template="/layouts/classic.jsp">
+ <put-attribute name="title" value="Tiles tutorial homepage" />
+ <put-attribute name="header" value="/tiles/banner.jsp" />
+ <put-attribute name="menu" value="/tiles/common_menu.jsp" />
+ <put-attribute name="body" value="/tiles/home_body.jsp" />
+ <put-attribute name="footer" value="/tiles/credits.jsp" />
+ </definition>
+</tiles-definitions>
+------------------------------------
+
+* Render the definition
+
+ After creating the definition, you can render it:
+
+ * by using the <<<\<tiles:insertDefinition /\>>>> tag, inserting it in a JSP
+ page:
+
+-------------------------------------
+<%@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="tiles" %>
+<tiles:insertDefinition name="myapp.homepage" />
+-------------------------------------
+
+ * in other cases, you can render directly in the response, by using the Tiles
+ container:
+
+-----------------------------------
+TilesContainer container = TilesAccess.getContainer(
+ request.getSession().getServletContext());
+container.render("myapp.homepage", request, response);
+-----------------------------------
+
+ * by using {{{../advanced/utils.html}Rendering Utilities}} provided by Tiles. For instance,
+ if you've configured <<<TilesDispatchServlet>>>, you can render the definition above by
+ requesting <<<http://example.com/webapp/myapp.homepage.tiles>>>.
+
+ * by using a supporting framework. See
+ {{{../integration/index.html}Integrations}} for a list of supporting
+ frameworks.
diff --git a/Java-base/tiles/src/src/site/apt/tutorial/configuration.apt b/Java-base/tiles/src/src/site/apt/tutorial/configuration.apt
new file mode 100644
index 000000000..f72a61de0
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/tutorial/configuration.apt
@@ -0,0 +1,74 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Tiles Configuration
+ -----------
+
+Configuring Tiles in your web application
+
+ Tiles has always been a web application package, usually used in conjunction
+ with Struts. Apache Tiles\u0099 evolved to the point of being technology-independent, but
+ its use in a Servlet-based web application is still the most frequent use case.
+
+* Required libraries
+
+ The first thing is to install the required libraries. For the purpose of this tutorial,
+ we will install everything: the more we can do, the better. Just know that a
+ more "lightweight" but limited configuration is available.
+
+ If you're using maven, just include this dependency, it will include the rest:
+
+-------------
+<groupId>org.apache.tiles</groupId>
+<artifactId>tiles-extras</artifactId>
+-------------
+
+ If you're not using maven, just {{{/download.html}download}} tiles and copy all the jars
+ into the /WEB-INF/lib directory.
+
+* Starting Tiles engine
+
+ Load the tiles container by using the appropriate listener it in your <<<web.xml>>> file. Since we
+ decided to load everything, we'll use <<<CompleteAutoloadTilesListener>>>:
+
+-------------------------------
+<listener>
+ <listener-class>org.apache.tiles.extras.complete.CompleteAutoloadTilesListener</listener-class>
+</listener>
+-------------------------------
+
+ For this tutorial, we'll configure Tiles to work directly with the servlet API, without a controller.
+ In the real world, you'll probably use an MVC framework like Struts or Shale or Spring. You have to
+ configure your framework to work with Tiles; please refer to your framework's documentation for that.
+ For now, we'll just declare <<<TilesDispatchServlet>>> in <<<web.xml>>>:
+
+-------------------------------
+<servlet>
+ <servlet-name>Tiles Dispatch Servlet</servlet-name>
+ <servlet-class>org.apache.tiles.web.util.TilesDispatchServlet</servlet-class>
+</servlet>
+<servlet-mapping>
+ <servlet-name>Tiles Dispatch Servlet</servlet-name>
+ <url-pattern>*.tiles</url-pattern>
+</servlet-mapping>
+-------------------------------
+
+ This means that any request to an URL ending in ".tiles" will be dispatched directly to the matching
+ Tiles Definition.
diff --git a/Java-base/tiles/src/src/site/apt/tutorial/index.apt b/Java-base/tiles/src/src/site/apt/tutorial/index.apt
new file mode 100644
index 000000000..fb0262c61
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/tutorial/index.apt
@@ -0,0 +1,68 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Tutorial
+ -----------
+
+Introduction
+
+ This tutorial is intended to provide a help for first-time Tiles users, in the context of a web application.
+
+Summary
+
+ [[1]] {{{./pattern.html}The "composite view" pattern}}
+
+ [[2]] {{{./configuration.html}Configuring your web application}}
+
+ [[3]] {{{./basic/index.html}Basic Usage}}
+
+ [[1]] {{{./basic/concepts.html}Tiles Concepts}}
+
+ [[2]] {{{./basic/pages.html}Creating Tiles Pages}}
+
+ [[4]] {{{./advanced/index.html}Advanced Topics}}
+
+ [[1]] {{{./advanced/nesting-extending.html}Nesting and Extending Definitions}}
+
+ [[2]] {{{./advanced/list-attributes.html}List Attributes}}
+
+ [[3]] {{{./advanced/runtime.html}Runtime Composition}}
+
+ [[4]] {{{./advanced/preparer.html}View Preparers}}
+
+ [[5]] {{{./advanced/utils.html}Rendering Utilities}}
+
+ [[6]] {{{./advanced/l10n.html}Tiles Localization}}
+
+ [[7]] {{{./advanced/wildcard.html}Wildcard support}}
+
+ [[8]] {{{./advanced/el-support.html}EL support}}
+
+ [[8]] {{{./advanced/attribute-rendering.html}Attribute rendering}}
+
+ [[9]] {{{./advanced/multiple-containers.html}Using multiple containers}}
+
+ [[10]] {{{./advanced/security.html}Security}}
+
+ [[5]] {{{./integration/index.html}Integration with other technologies}}
+
+ [[1]] {{{./integration/frameworks.html}Integration with other frameworks}}
+
+ [[2]] {{{./integration/view.html}Integration with other view technologies}}
diff --git a/Java-base/tiles/src/src/site/apt/tutorial/integration/frameworks.apt b/Java-base/tiles/src/src/site/apt/tutorial/integration/frameworks.apt
new file mode 100644
index 000000000..60867a0ef
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/tutorial/integration/frameworks.apt
@@ -0,0 +1,43 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Integration with other Frameworks
+ -----------
+
+Integration with other web Frameworks
+
+ Tiles can be integrated with other web frameworks. Usually this kind of
+ integration is made through extensions/plugins to Tiles.
+
+ * {{{http://struts.apache.org/1.x/index.html}Struts 1}}: Currently under
+ development. A Struts 1 plugin is available in the SVN trunk, that presumably
+ will be released along with Struts 1.4.
+
+ * {{{http://struts.apache.org/development/2.x/struts2-plugins/struts2-tiles-plugin/apidocs/index.html}Struts 2}}: at the time of this
+ writing, the Struts 2 Tiles plugin still uses Tiles version 2.
+
+ * {{{http://docs.spring.io/spring/docs/3.2.x/spring-framework-reference/html/view.html#view-tiles}Spring MVC}}:
+ Spring-3.2 can integration up to Tiles-2 and Tiles-3.
+
+
+
+ For a closer look at custom integrations the
+ {{{https://github.com/spring-projects/spring-framework/tree/master/spring-webmvc-tiles3/src/main/java/org/springframework/web/servlet/view/tiles3}spring code}}:
+ forms a good example.
diff --git a/Java-base/tiles/src/src/site/apt/tutorial/integration/freemarker.apt b/Java-base/tiles/src/src/site/apt/tutorial/integration/freemarker.apt
new file mode 100644
index 000000000..0e6b974f6
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/tutorial/integration/freemarker.apt
@@ -0,0 +1,121 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Integration with FreeMarker
+ -----------
+
+Integration with FreeMarker
+
+ {{{http://freemarker.sourceforge.net/}FreeMarker}} is a templating framework
+ that can be used as a replacement for JavaServer Pages (JSP). Tiles can be
+ used with FreeMarker through the use of Tiles FreeMarker package.
+
+* Configuration
+
+ To use FreeMarker together with Tiles
+
+ * Add FreeMarker jars (tested with FreeMarker 2.3.15).
+
+ * Add <<<tiles-template-x.x.x.jar>>> and <<<tiles-freemarker-x.x.x.jar>>> files
+ to your application
+
+ * To access ".ftl" files from HTTP requests, add this piece of configuration in <<<web.xml>>>
+ (the parameters can be modified as needed).
+
+----------------------------------
+<servlet>
+ <servlet-name>freemarker</servlet-name>
+ <servlet-class>org.apache.tiles.freemarker.servlet.TilesFreemarkerServlet</servlet-class>
+
+ <!-- FreemarkerServlet settings: -->
+ <init-param>
+ <param-name>TemplatePath</param-name>
+ <param-value>/</param-value>
+ </init-param>
+ <init-param>
+ <param-name>NoCache</param-name>
+ <param-value>true</param-value>
+ </init-param>
+ <init-param>
+ <param-name>ContentType</param-name>
+ <param-value>text/html</param-value>
+ </init-param>
+
+ <!-- FreeMarker settings: -->
+ <init-param>
+ <param-name>template_update_delay</param-name>
+ <param-value>0</param-value> <!-- 0 is for development only! Use higher value otherwise. -->
+ </init-param>
+ <init-param>
+ <param-name>default_encoding</param-name>
+ <param-value>ISO-8859-1</param-value>
+ </init-param>
+ <init-param>
+ <param-name>number_format</param-name>
+ <param-value>0.##########</param-value>
+ </init-param>
+
+ <load-on-startup>5</load-on-startup>
+</servlet>
+----------------------------------
+
+ * To access ".ftl" files as attributes, register FreeMarkerAttributeRenderer
+ this way (only available in a servlet environment):
+
+----------------------------------
+@Override
+protected void registerAttributeRenderers(
+ BasicRendererFactory rendererFactory, TilesApplicationContext applicationContext,
+ TilesRequestContextFactory contextFactory,
+ TilesContainer container, AttributeEvaluator evaluator) {
+ super.registerAttributeRenderers(rendererFactory, applicationContext, contextFactory,
+ container, evaluator);
+ FreeMarkerAttributeRenderer freemarkerRenderer = new FreeMarkerAttributeRenderer();
+ freemarkerRenderer.setApplicationContext(applicationContext);
+ freemarkerRenderer.setEvaluator(evaluator);
+ freemarkerRenderer.setRequestContextFactory(contextFactory);
+ freemarkerRenderer.setParameter("TemplatePath", "/");
+ freemarkerRenderer.setParameter("NoCache", "true");
+ freemarkerRenderer.setParameter("ContentType", "text/html");
+ freemarkerRenderer.setParameter("template_update_delay", "0");
+ freemarkerRenderer.setParameter("default_encoding", "ISO-8859-1");
+ freemarkerRenderer.setParameter("number_format", "0.##########");
+ freemarkerRenderer.commit();
+ rendererFactory.registerRenderer("freemarker", freemarkerRenderer);
+}
+----------------------------------
+
+ This way you can specify an attribute that is rendered directly using this syntax:
+
+----------------------------------
+<put-attribute name="myAttribute" value="/pages/myPage.ftl" type="freemarker" />
+----------------------------------
+
+* Usage in FreeMarker templates
+
+ Tiles directives are available this way:
+
+----------------------------------
+<@tiles.nameOfDirective>
+ Other stuff...
+</@tiles.nameOfDirective>
+----------------------------------
+
+ For details about directives see the {{{../../apidocs/index.html}Javadocs}}.
diff --git a/Java-base/tiles/src/src/site/apt/tutorial/integration/index.apt b/Java-base/tiles/src/src/site/apt/tutorial/integration/index.apt
new file mode 100644
index 000000000..1593ad813
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/tutorial/integration/index.apt
@@ -0,0 +1,32 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Tiles Integrations
+ -----------
+
+Tiles integrations
+
+ Tiles can be integrated with various frameworks and view technologies, to
+ include Tiles elements into their specific features.
+
+ * {{{./frameworks.html}Integration in web frameworks}}.
+
+ * {{{./view.html}Integration in view technologies}}.
+
diff --git a/Java-base/tiles/src/src/site/apt/tutorial/integration/velocity.apt b/Java-base/tiles/src/src/site/apt/tutorial/integration/velocity.apt
new file mode 100644
index 000000000..a5c5529e5
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/tutorial/integration/velocity.apt
@@ -0,0 +1,163 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Integration with Apache Velocity
+ -----------
+
+Integration with Apache Velocity
+
+ {{{http://velocity.apache.org/}Apache Velocity}} is a templating framework
+ that can be used as a replacement for JavaServer Pages (JSP). Tiles can be
+ used with Velocity through the use of Tiles Velocity package.
+
+* Configuration
+
+ To use Velocity together with Tiles
+
+ * Add Velocity (1.7 or better) and Velocity Tools (2.0 or better) jars to your application.
+
+ * Add <<<tiles-template-x.x.x.jar>>> and <<<tiles-velocity-x.x.x.jar>>> files
+ to your application.
+ * Add this code in you <<<velocity.properties>>> file:
+
+----------------------------------
+userdirective=org.apache.tiles.velocity.template.AddAttributeDirective,\
+ org.apache.tiles.velocity.template.AddListAttributeDirective,\
+ org.apache.tiles.velocity.template.DefinitionDirective,\
+ org.apache.tiles.velocity.template.GetAsStringDirective,\
+ org.apache.tiles.velocity.template.ImportAttributeDirective,\
+ org.apache.tiles.velocity.template.InsertAttributeDirective,\
+ org.apache.tiles.velocity.template.InsertDefinitionDirective,\
+ org.apache.tiles.velocity.template.InsertTemplateDirective,\
+ org.apache.tiles.velocity.template.PutAttributeDirective,\
+ org.apache.tiles.velocity.template.PutListAttributeDirective
+----------------------------------
+
+
+ * To access ".vm" files from HTTP requests, add this piece of configuration in <<<web.xml>>>
+ (the parameters can be modified as needed).
+
+----------------------------------
+<servlet>
+ <servlet-name>velocity</servlet-name>
+ <servlet-class>org.apache.velocity.tools.view.VelocityViewServlet</servlet-class>
+
+ <init-param>
+ <param-name>org.apache.velocity.toolbox</param-name>
+ <param-value>/WEB-INF/tools.xml</param-value>
+ </init-param>
+
+ <init-param>
+ <param-name>org.apache.velocity.properties</param-name>
+ <param-value>/WEB-INF/velocity.properties</param-value>
+ </init-param>
+</servlet>
+----------------------------------
+
+ * To access ".vm" files as attributes, register VelocityAttributeRenderer
+ this way (only available in a servlet environment):
+
+----------------------------------
+@Override
+protected void registerAttributeRenderers(
+ BasicRendererFactory rendererFactory, TilesApplicationContext applicationContext,
+ TilesRequestContextFactory contextFactory,
+ TilesContainer container, AttributeEvaluator evaluator) {
+ super.registerAttributeRenderers(rendererFactory, applicationContext, contextFactory,
+ container, evaluator);
+
+ VelocityAttributeRenderer velocityRenderer = new VelocityAttributeRenderer();
+ velocityRenderer.setApplicationContext(applicationContext);
+ velocityRenderer.setEvaluator(evaluator);
+ velocityRenderer.setRequestContextFactory(contextFactory);
+ velocityRenderer.setParameter("org.apache.velocity.toolbox", "/WEB-INF/tools.xml");
+ velocityRenderer.setParameter("org.apache.velocity.properties", "/WEB-INF/velocity.properties");
+ velocityRenderer.commit();
+ rendererFactory.registerRenderer("velocity", velocityRenderer);
+}
+----------------------------------
+
+ This way you can specify an attribute that is rendered directly using this syntax:
+
+----------------------------------
+<put-attribute name="myAttribute" value="/pages/myPage.vm" type="velocity" />
+----------------------------------
+
+* Usage in Velocity templates
+
+ There are two ways to use Tiles-Velocity integration:
+
+ * the <<<tiles>>> tool, that is a Velocity-style tool:
+
+----------------------------------
+$tilesAlt.startAttributeContext()
+$set($templateAttribute = $tilesAlt.createTemplateAttribute("/page/myTemplate.vm"))
+$set($attributeContext = $tilesAlt.getAttributeContext())
+ $set($attribute = $tilesAlt.createAttribute())
+ $attribute.setValue("This is the title.")
+ $attributeContext.putAttribute("title", $attribute})
+
+ $set($attribute = $tilesAlt.createAttribute())
+ $attribute.setValue("/velocity/header.vm")
+ $attribute.setRenderer("velocity")
+ $attributeContext.putAttribute("header", $attribute})
+
+ $set($attribute = $tilesAlt.createAttribute())
+ $attribute.setValue("/velocity/body.vm")
+ $attribute.setRenderer("velocity")
+ $attributeContext.putAttribute("body", $attribute})
+
+$tilesAlt.render($templateAttribute)
+$tilesAlt.endAttributeContext()
+----------------------------------
+
+ * the <<<tiles>>> directives, that have a tag-like meaning.
+
+----------------------------------
+#tiles_insertTemplate({"template":"/page/myTemplate.vm"})
+ #tiles_putAttribute({"name":"title", "value":"This is the title."})#end
+ #tiles_putAttribute({"name":"header", "value":"/velocity/header.vm", "type":"velocity"})#end
+ #tiles_putAttribute({"name":"body", "value":"/velocity/body.vm", "type":"velocity"})#end
+#end
+----------------------------------
+
+ Other <<<tiles>>> directives are:
+
+ * <<<getAsString(String attributeName)>>> - get the value of named attribute as string.
+
+ * <<<importAttribute(String attributeName, String toName)>>> - import the named attribute into the scope of
+ template context under the (optional) custom name.
+
+ * <<<insertAttribute(String attributeName)>>> - inserts given attribute in the output in its own context.
+ If this is a string a string is printed, if this is a definition - it is included in the output.
+
+ * <<<insertAttribute(String attributeName, boolean ownContext)>>> - inserts given attribute in the output.
+ If this is a string a string is printed, if this is a definition - it is included in the output. You can specify whether
+ a separate context is created for rendering the definition - in this case variables with duplicate names
+ will not be inherited from the parent definition
+
+ * <<<insertDefinition(String definitionName)>>> - renders a definition in its own context.
+
+ * <<<insertDefinition(String definitionName, boolean ownContext)>>> - inserts definition, optionally in the shared context.
+
+ * <<<insertTemplate(String template)>>> - inserts a named page, equivalent to Velocity's <<<#parse>>>.
+
+
+ For details about the tool and directives see the {{{../../apidocs/index.html}Javadocs}}.
diff --git a/Java-base/tiles/src/src/site/apt/tutorial/integration/view.apt b/Java-base/tiles/src/src/site/apt/tutorial/integration/view.apt
new file mode 100644
index 000000000..3a02f867d
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/tutorial/integration/view.apt
@@ -0,0 +1,33 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ Integration with other View Technologies
+ -----------
+
+Integration with other View Technologies
+
+ Currently Apache Tiles\u0099 is not only integrated with JavaServer Pages, but it can be used
+ with:
+
+ * {{{./freemarker.html}FreeMarker}}.
+
+ * {{{./velocity.html}Velocity}}.
+
+ * Mustache.
diff --git a/Java-base/tiles/src/src/site/apt/tutorial/pattern.apt b/Java-base/tiles/src/src/site/apt/tutorial/pattern.apt
new file mode 100644
index 000000000..2d39d4de1
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/tutorial/pattern.apt
@@ -0,0 +1,109 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ The Composite View Pattern
+ -----------
+
+The Composite View Pattern
+
+ All websites have something in common: they are made of pages that share
+ similar structures. The pages share the same layout, while each page is made
+ of different independent pieces, but always placed in the same position across
+ all the site.
+
+ The <<Composite View>> pattern formalizes this typical use, by allowing to
+ create pages that have a similar structure, in which each section of the page
+ vary in different situations.
+
+* How the pattern works
+
+ To understand this pattern, let's take an example. In the following picture
+ you can see a typical structure of a web page.
+
+[../images/tiled_page.png] The "classic layout", a typical structure of a web
+page.
+
+ This structure is called "Classic Layout". The template organizes the page
+ according to this layout, putting each "piece" in the needed place, so that
+ the header goes up, the footer down, etc.
+
+ It can happen that, for example clicking on a link, it is needed to change
+ only a part of the page, typically the body.
+
+[../images/page_to_page.png] The body changes, while the rest remains the same.
+
+ As you can see, the pages are different, but their difference is only in the
+ body part. Note that, however, <<the pages are distinct>>, it is not like a
+ refresh of a frame in a frameset!
+
+ Using the composite view pattern, the other part of the page have been reused,
+ and the layout consistence has been preserved.
+
+* The role of the View Helper
+
+ Each piece of the composed page can have a "view helper". This pattern allows
+ the preparation of the data to be displayed in a consistent way for the page
+ piece itself, for example to create a menu.
+
+* Composite View vs. Decorator
+
+ Tiles is a composite view framework: it allows to reuse page pieces across
+ the application. But another approach to achieve the same result is using the
+ <<Decorator pattern>>. For example,
+ {{{http://www.sitemesh.org/}Sitemesh}} is based on the Decorator
+ pattern.
+
+ Instead of creating a template and organizing the pieces together, the
+ Decorator pattern (in this case) takes a simple HTML page, transforms it
+ adding the missing pieces (in our example, adding header, footer and menu) and
+ finally renders it.
+
+ Here you can find a comparison table between the two patterns.
+
+*---------------+--------------------------------+-----------------------------+
+| <<Aspect>> | <<Composite View>> | <<Decorator>> |
+*---------------+--------------------------------+-----------------------------+
+| Reusability | The different parts of the | Each decorator can be |
+| | page (template and pieces) can | reused, but the decoration |
+| | be reused across the whole | itself can be applied to |
+| | application. | one page at a time. |
+*---------------+--------------------------------+-----------------------------+
+| Ease of | Each page must be defined | The decorator can be |
+| configuration | explicitly. | applied even to the entire |
+| | | application. |
+*---------------+--------------------------------+-----------------------------+
+| Runtime | The pages can be configured | Since one page is decorated |
+| configuration | and organized at runtime | at a time, this feature is |
+| | | not present. |
+*---------------+--------------------------------+-----------------------------+
+| Performances | Low overhead for composition. | The page to be decorated |
+| | | has to be parsed. |
+*---------------+--------------------------------+-----------------------------+
+
+
+* References
+
+ You can see the complete description of the Composite View pattern at:
+
+ * {{{http://java.sun.com/blueprints/corej2eepatterns/Patterns/CompositeView.html}
+ Sun's Core J2EE Patterns}}
+
+ * {{{http://java.sun.com/blueprints/patterns/CompositeView.html}
+ Sun's Blueprints Patterns}}
diff --git a/Java-base/tiles/src/src/site/apt/whats-new.apt b/Java-base/tiles/src/src/site/apt/whats-new.apt
new file mode 100644
index 000000000..eecc4017e
--- /dev/null
+++ b/Java-base/tiles/src/src/site/apt/whats-new.apt
@@ -0,0 +1,52 @@
+~~ $Id$
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you 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.
+~~
+ -----------
+ What's new in Tiles 3.0
+ -----------
+
+What's new in Tiles 3.0
+
+* New features in Tiles 3.0
+
+ * {{{/tiles-request/}Apache Request}}: a framework independent request abstraction. Implementations for Servlet,
+ Portlet, JSP, Velocity, FreeMarker and Mustache.
+
+ * {{{/tiles-autotag/}Apache Autotag}}: a tool that automatically generates tags (or tag-like) artifact from a common template code for a range of templating languages.
+ All the Tiles 3 boilerplate code to templating models has been removed and uses the Autotag plugins instead:
+ it's a lot of boilerplate, boring code, now generated automatically.
+
+* Deprecations in Tiles 3.0
+
+ * Starting Tiles in a web environment using a dummy Servlet. Use a ServletContextListener instead.
+
+ * Don't use the AttributeContext interface to pass attribute values to Tiles. Expression Languages are an easier, more maintainable
+ way to change the value of attributes on a per-render basis.
+
+ * ...
+
+* Removals in Tiles 3.0
+
+ * Upgraded from JavaSE 5.0 to JavaSE 6.0.
+
+ * Upgraded from Servlet 2.4 and JSP 2.0 to Servlet 2.5 and JSP 2.1.
+
+ * Changed the Java API to adopt the Request API. The XML files and taglibs are compatible with tiles 2.2.
+
+ * Dropped the parameter based configuration that was deprecated in 2.2.
diff --git a/Java-base/tiles/src/src/site/resources/images/page_to_page.png b/Java-base/tiles/src/src/site/resources/images/page_to_page.png
new file mode 100644
index 0000000000000000000000000000000000000000..78883ad502ced4943c55a9ea1407cb5d72a4e779
GIT binary patch
literal 39217
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
FV1lr=Mn?bu
literal 0
HcmV?d00001
diff --git a/Java-base/tiles/src/src/site/resources/images/tiled_page.png b/Java-base/tiles/src/src/site/resources/images/tiled_page.png
new file mode 100644
index 0000000000000000000000000000000000000000..f8f2ee15239addedde47ad33c28be3ca28ea3bc4
GIT binary patch
literal 13126
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
literal 0
HcmV?d00001
diff --git a/Java-base/tiles/src/src/site/site.xml b/Java-base/tiles/src/src/site/site.xml
new file mode 100644
index 000000000..9cd30e5fe
--- /dev/null
+++ b/Java-base/tiles/src/src/site/site.xml
@@ -0,0 +1,206 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+/*
+ * $Id$
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you 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.
+ */
+-->
+<project name="Apache Tiles - Framework">
+ <skin>
+ <groupId>org.apache.maven.skins</groupId>
+ <artifactId>maven-fluido-skin</artifactId>
+ <version>1.3.0</version>
+ </skin>
+ <custom>
+ <fluidoSkin>
+ <topBarEnabled>true</topBarEnabled>
+ <sideBarEnabled>false</sideBarEnabled>
+ <searchEnabled>true</searchEnabled>
+ <gitHub>
+ <projectId>apache/tiles</projectId>
+ <ribbonOrientation>right</ribbonOrientation>
+ <ribbonColor>darkblue</ribbonColor>
+ </gitHub>
+ </fluidoSkin>
+ </custom>
+ <bannerLeft>
+ <name>Apache Tiles™</name>
+ <src>http://tiles.apache.org/images/logo.png</src>
+ <href>http://tiles.apache.org</href>
+ </bannerLeft>
+ <bannerRight>
+ <name>Apache Software Foundation</name>
+ <href>http://www.apache.org</href>
+ <src>https://tiles.apache.org/images/logos/asf_logo_url.svg</src>
+ </bannerRight>
+ <body>
+
+ <menu name="Apache Tiles™">
+ <item
+ name="Welcome"
+ href="../index.html"/>
+ <item
+ name="Tiles 3.0.x"
+ href="index.html"/>
+ <item
+ name="Autotag 1.0.x"
+ href="../tiles-autotag/index.html"/>
+ <item
+ name="Request 1.0.x"
+ href="../tiles-request/index.html"/>
+ <item
+ name="Security bulletins"
+ href="security/index.html"/>
+ </menu>
+ <menu name="User Documentation">
+ <item
+ name="What's new"
+ href="whats-new.html"/>
+ <item
+ name="Getting Started"
+ href="getting_started.html"/>
+ <item
+ name="Tutorial"
+ href="tutorial/index.html"
+ collapse="true">
+ <item
+ name="The composite view pattern"
+ href="tutorial/pattern.html"/>
+ <item
+ name="Configuration"
+ href="tutorial/configuration.html"/>
+ <item
+ name="Basic Usage"
+ href="tutorial/basic/index.html"
+ collapse="true">
+ <item
+ name="Tiles Concepts"
+ href="tutorial/basic/concepts.html"/>
+ <item
+ name="Creating Pages"
+ href="tutorial/basic/pages.html"/>
+ </item>
+ <item
+ name="Advanced Topics"
+ href="tutorial/advanced/index.html"
+ collapse="true">
+ <item
+ name="Nesting and Extending"
+ href="tutorial/advanced/nesting-extending.html"/>
+ <item
+ name="List Attributes"
+ href="tutorial/advanced/list-attributes.html"/>
+ <item
+ name="Runtime Composition"
+ href="tutorial/advanced/runtime.html"/>
+ <item
+ name="View Preparers"
+ href="tutorial/advanced/preparer.html"/>
+ <item
+ name="Rendering Utilities"
+ href="tutorial/advanced/utils.html"/>
+ <item
+ name="Localization"
+ href="tutorial/advanced/l10n.html"/>
+ <item
+ name="Wildcard support"
+ href="tutorial/advanced/wildcard.html"/>
+ <item
+ name="EL support"
+ href="tutorial/advanced/el-support.html"/>
+ <item
+ name="Attribute rendering"
+ href="tutorial/advanced/attribute-rendering.html"/>
+ <item
+ name="Multiple containers"
+ href="tutorial/advanced/multiple-containers.html"/>
+ <item
+ name="Security"
+ href="tutorial/advanced/security.html"/>
+ </item>
+ <item
+ name="Integrations"
+ href="tutorial/integration/index.html"
+ collapse="true">
+ <item
+ name="Frameworks"
+ href="tutorial/integration/frameworks.html"/>
+ <item
+ name="View technologies"
+ href="tutorial/integration/view.html">
+ <item
+ name="FreeMarker"
+ href="tutorial/integration/freemarker.html"/>
+ <item
+ name="Velocity"
+ href="tutorial/integration/velocity.html"/>
+ </item>
+ </item>
+ </item>
+ <item
+ name="Wiki"
+ href="http://cwiki.apache.org/TILES/"/>
+ <item
+ name="Struts Migration"
+ href="migration/index.html"/>
+ </menu>
+ <menu name="Reference">
+ <item
+ name="Configuration reference"
+ href="config-reference.html"/>
+ <item
+ name="Javadoc"
+ href="apidocs/index.html"/>
+ <item
+ name="Taglibdoc"
+ href="tiles-jsp/tlddoc/index.html"/>
+ <item
+ name="Taglib Reference"
+ href="tiles-jsp/tagreference.html"/>
+ <item
+ name="DTD Doc"
+ href="tiles-core/dtddoc/index.html"/>
+ </menu>
+
+ <menu name="Developers">
+ <item
+ name="Building"
+ href="dev/building.html"/>
+ <item
+ name="Snapshots"
+ href="dev/snapshots.html"/>
+ <item
+ name="Release Process"
+ href="dev/release.html"/>
+ <item
+ name="Selenium Testing"
+ href="selenium.html"/>
+ </menu>
+
+ <menu ref="modules" />
+ <menu ref="reports" />
+
+ <footer>
+ <div class="row span12">
+ Apache Tiles, Tiles, Apache, the Apache feather logo, and the Apache Tiles
+ project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </footer>
+ </body>
+</project>
diff --git a/Java-base/tiles/src/src/site/xdoc/dev/building.xml b/Java-base/tiles/src/src/site/xdoc/dev/building.xml
new file mode 100644
index 000000000..7fb099a03
--- /dev/null
+++ b/Java-base/tiles/src/src/site/xdoc/dev/building.xml
@@ -0,0 +1,108 @@
+<?xml version="1.0"?>
+<!--
+/*
+ * $Id$
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you 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.
+ */
+-->
+<document>
+
+ <properties>
+ <title>Apache Tiles
+
+
+
+
+
+
For all the next instructions, we assume that you downloaded and
+ installed Maven.
+
To download packages from the source repository, you need to
+ download and install
+ Subversion.
+
If you want to build something including JavaDocs (assemblies,
+ sites and JavaDoc report itself) you need to install
+ GraphViz, otherwise you will
+ notice missing pictures inside JavaDocs pages.
+
+
+
To build Tiles from source you need to:
+
+
download the source
+ distribution, or checkout the latest version:
+
svn co http://svn.apache.org/repos/asf/tiles/framework/trunk/tiles-parent
Looking for snapshot builds of the latest version of Tiles?
+ Snapshots are occasionally published to Apache's Maven snapshot
+ repository, which can be accessed with the following configuration:
You can see Tiles in action by downloading a snapshot of the 'tiles-test' webapp,
+
+ here.
+
+
+
+
+
+
diff --git a/Java-base/tiles/src/src/site/xdoc/images/page_to_page.svg b/Java-base/tiles/src/src/site/xdoc/images/page_to_page.svg
new file mode 100644
index 000000000..72ac013c0
--- /dev/null
+++ b/Java-base/tiles/src/src/site/xdoc/images/page_to_page.svg
@@ -0,0 +1,450 @@
+
+
+
diff --git a/Java-base/tiles/src/src/site/xdoc/images/tiled_page.svg b/Java-base/tiles/src/src/site/xdoc/images/tiled_page.svg
new file mode 100644
index 000000000..7fe04ff09
--- /dev/null
+++ b/Java-base/tiles/src/src/site/xdoc/images/tiled_page.svg
@@ -0,0 +1,277 @@
+
+
+
diff --git a/Java-base/tiles/src/tiles-api/pom.xml b/Java-base/tiles/src/tiles-api/pom.xml
new file mode 100644
index 000000000..5d1749d45
--- /dev/null
+++ b/Java-base/tiles/src/tiles-api/pom.xml
@@ -0,0 +1,99 @@
+
+
+
+
+
+ org.apache.tiles
+ tiles-parent
+ 3.1-SNAPSHOT
+
+
+ 4.0.0
+ tiles-api
+ jar
+ Tiles - API
+ Tiles APIs, containing interfaces and classes to interact with
+ Tiles.
+
+
+ org.apache.tiles.api
+
+ 5
+
+
+
+
+
+
+ src/main/resources
+
+ LICENSE.txt
+ NOTICE.txt
+
+
+
+ src/main/resources
+
+ LICENSE.txt
+ NOTICE.txt
+
+ META-INF
+
+
+
+
+
+
+
+
+ javax.servlet
+ servlet-api
+ test
+
+
+
+ junit
+ junit
+ test
+
+
+ org.easymock
+ easymockclassextension
+ test
+
+
+ org.slf4j
+ slf4j-api
+
+
+ org.slf4j
+ slf4j-jdk14
+ test
+
+
+ org.apache.tiles
+ tiles-request-api
+
+
+
diff --git a/Java-base/tiles/src/tiles-api/src/main/java/org/apache/tiles/Attribute.java b/Java-base/tiles/src/tiles-api/src/main/java/org/apache/tiles/Attribute.java
new file mode 100644
index 000000000..ee0652cb1
--- /dev/null
+++ b/Java-base/tiles/src/tiles-api/src/main/java/org/apache/tiles/Attribute.java
@@ -0,0 +1,384 @@
+/*
+ * $Id$
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you 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.tiles;
+
+import static org.apache.tiles.CompareUtil.*;
+
+import java.io.Serializable;
+import java.util.HashSet;
+import java.util.Iterator;
+import java.util.Set;
+
+import org.apache.tiles.request.Request;
+
+/**
+ * Common implementation of attribute definition.
+ *
+ * @version $Rev$ $Date$
+ */
+public class Attribute implements Serializable, Cloneable {
+
+ /**
+ * The name of the template renderer.
+ */
+ private static final String TEMPLATE_RENDERER = "template";
+
+ /**
+ * The roles that can render this attribute.
+ * @since 2.0.6
+ */
+ protected Set roles = null;
+
+ /**
+ * The value of the attribute.
+ */
+ protected Object value = null;
+
+ /**
+ * The expression to evaluate. Ignored if {@link #value} is not
+ * null.
+ *
+ * @since 2.2.0
+ */
+ protected Expression expressionObject = null;
+
+ /**
+ * The renderer name of the attribute. Default names are string,
+ * template, definition, object.
+ */
+ private String renderer = null;
+
+ /**
+ * Constructor.
+ *
+ */
+ public Attribute() {
+ }
+
+ /**
+ * Constructor.
+ *
+ * @param value Object to store.
+ */
+ public Attribute(Object value) {
+ this.value = value;
+ }
+
+ /**
+ * Copy constructor.
+ *
+ * @param attribute The attribute to copy from.
+ */
+ public Attribute(Attribute attribute) {
+ this.roles = attribute.roles;
+ this.value = attribute.getValue();
+ if (attribute.expressionObject != null) {
+ this.expressionObject = new Expression(attribute.expressionObject);
+ } else {
+ this.expressionObject = null;
+ }
+ this.renderer = attribute.renderer;
+ }
+
+ /**
+ * Constructor.
+ *
+ * @param value Object to store.
+ * @param role Asociated role.
+ */
+ public Attribute(Object value, String role) {
+ this.value = value;
+ setRole(role);
+ }
+
+ /**
+ * Constructor.
+ *
+ * @param value Object to store. If specified, the expression
+ * parameter will be ignored.
+ * @param expression The expression to be evaluated. Ignored if the
+ * value is not null.
+ * @param role Associated role.
+ * @param rendererName The renderer name.
+ * @since 2.2.0
+ */
+ public Attribute(Object value, Expression expression, String role, String rendererName) {
+ this.value = value;
+ this.expressionObject = expression;
+ this.renderer = rendererName;
+ setRole(role);
+ }
+
+ /**
+ * Creates a template attribute, starting from the name of the template.
+ *
+ * @param template The template that will be rendered.
+ * @return The template attribute.
+ * @since 2.1.2
+ */
+ public static Attribute createTemplateAttribute(String template) {
+ Attribute attribute = new Attribute();
+ attribute.setValue(template);
+ attribute.setRenderer(TEMPLATE_RENDERER);
+ return attribute;
+ }
+
+ /**
+ * Creates a template attribute, starting from the name of the template.
+ *
+ * @param template The template that will be rendered.
+ * @param templateExpression The template expression that will be evaluated
+ * to a template.
+ * @param templateType The type, or renderer, of the template. If null, the
+ * default template will be used.
+ * @param role The comma-separated roles for which the template is
+ * authorized to be rendered.
+ * @return The template attribute.
+ * @since 2.2.2
+ */
+ public static Attribute createTemplateAttribute(String template,
+ String templateExpression, String templateType, String role) {
+ Attribute templateAttribute = createTemplateAttribute(template);
+ templateAttribute.setRole(role);
+ if (templateType != null) {
+ templateAttribute.setRenderer(templateType);
+ }
+ templateAttribute
+ .setExpressionObject(Expression
+ .createExpressionFromDescribedExpression(templateExpression));
+ return templateAttribute;
+ }
+
+ /**
+ * Creates a template attribute, starting from the expression to evaluate to
+ * obtain the template.
+ *
+ * @param templateExpression The expression to evaluate.
+ * @return The template attribute.
+ * @since 2.1.2
+ */
+ public static Attribute createTemplateAttributeWithExpression(
+ String templateExpression) {
+ Attribute attribute = new Attribute();
+ attribute.setExpressionObject(new Expression(templateExpression));
+ attribute.setRenderer(TEMPLATE_RENDERER);
+ return attribute;
+ }
+
+ /**
+ * Get role.
+ * @return the name of the required role(s)
+ */
+ public String getRole() {
+ String retValue = null;
+
+ if (roles != null && !roles.isEmpty()) {
+ StringBuilder builder = new StringBuilder();
+ Iterator roleIt = roles.iterator();
+ if (roleIt.hasNext()) {
+ builder.append(roleIt.next());
+ while (roleIt.hasNext()) {
+ builder.append(",");
+ builder.append(roleIt.next());
+ }
+ retValue = builder.toString();
+ }
+ }
+
+ return retValue;
+ }
+
+ /**
+ * Returns the roles that can render this attribute.
+ *
+ * @return The enabled roles.
+ * @since 2.0.6
+ */
+ public Set getRoles() {
+ return roles;
+ }
+
+ /**
+ * Set role.
+ *
+ * @param role Associated role.
+ */
+ public void setRole(String role) {
+ if (role != null && role.trim().length() > 0) {
+ String[] rolesStrings = role.split("\\s*,\\s*");
+ roles = new HashSet();
+ for (int i = 0; i < rolesStrings.length; i++) {
+ roles.add(rolesStrings[i]);
+ }
+ } else {
+ roles = null;
+ }
+ }
+
+ /**
+ * Sets the roles that can render this attribute.
+ *
+ * @param roles The enabled roles.
+ * @since 2.0.6
+ */
+ public void setRoles(Set roles) {
+ this.roles = roles;
+ }
+
+ /**
+ * Get value.
+ * @return the value
+ */
+ public Object getValue() {
+ return value;
+ }
+
+ /**
+ * Set value.
+ *
+ * @param value New value.
+ */
+ public void setValue(Object value) {
+ this.value = value;
+ }
+
+ /**
+ * Returns The expression to evaluate. Ignored if {@link #value} is not
+ * null.
+ *
+ * @return The expression to be evaluated.
+ * @since 2.2.0
+ */
+ public Expression getExpressionObject() {
+ return expressionObject;
+ }
+
+ /**
+ * Sets The expression to evaluate. Ignored if {@link #value} is not
+ * null.
+ *
+ * @param expressionObject The expression to be evaluated.
+ * @since 2.2.0
+ */
+ public void setExpressionObject(Expression expressionObject) {
+ this.expressionObject = expressionObject;
+ }
+
+ /** {@inheritDoc} */
+ @Override
+ public String toString() {
+ if (value != null) {
+ return value.toString();
+ }
+ return null;
+ }
+
+ /**
+ * Returns the renderer name to use.
+ *
+ * @return The renderer name.
+ * @since 2.1.0
+ */
+ public String getRenderer() {
+ return renderer;
+ }
+
+ /**
+ * Sets the renderer name to use.
+ *
+ * @param rendererName The renderer.
+ * @since 2.1.0
+ */
+ public void setRenderer(String rendererName) {
+ this.renderer = rendererName;
+ }
+
+ /**
+ * Inherits an attribute, i.e. overwrites null properties with the ones
+ * provided by the attribute.
+ *
+ * @param attribute The attribute to inherit.
+ * @since 2.1.2
+ */
+ public void inherit(Attribute attribute) {
+ if (value == null) {
+ value = attribute.getValue();
+ }
+ Expression targetExpressionObject = attribute.getExpressionObject();
+ if (targetExpressionObject != null
+ && (expressionObject == null || expressionObject
+ .getExpression() == null)) {
+ expressionObject = new Expression(targetExpressionObject);
+ }
+ if (roles == null || roles.isEmpty()) {
+ roles = attribute.getRoles();
+ }
+ if (renderer == null) {
+ renderer = attribute.getRenderer();
+ }
+ }
+
+ /** {@inheritDoc} */
+ @Override
+ public boolean equals(Object obj) {
+ Attribute attribute = (Attribute) obj;
+ return nullSafeEquals(value, attribute.value)
+ && nullSafeEquals(renderer, attribute.renderer)
+ && nullSafeEquals(roles, attribute.roles)
+ && nullSafeEquals(expressionObject, attribute.expressionObject);
+ }
+
+ /**
+ * Checks if the current user can use this attribute.
+ *
+ * @param request The request context.
+ * @return true if the current user can see this attribute.
+ * @since 3.0.0
+ */
+ public boolean isPermitted(Request request) {
+ if (roles == null || roles.isEmpty()) {
+ return true;
+ }
+
+ boolean retValue = false;
+
+ for (Iterator roleIt = roles.iterator(); roleIt.hasNext()
+ && !retValue;) {
+ retValue = request.isUserInRole(roleIt.next());
+ }
+
+ return retValue;
+ }
+
+ /** {@inheritDoc} */
+ @Override
+ public int hashCode() {
+ return nullSafeHashCode(value) + nullSafeHashCode(renderer)
+ + nullSafeHashCode(roles) + nullSafeHashCode(expressionObject);
+ }
+
+ /** {@inheritDoc} */
+ @Override
+ public Attribute clone() {
+ return new Attribute(this);
+ }
+}
diff --git a/Java-base/tiles/src/tiles-api/src/main/java/org/apache/tiles/AttributeContext.java b/Java-base/tiles/src/tiles-api/src/main/java/org/apache/tiles/AttributeContext.java
new file mode 100644
index 000000000..ab899ec2e
--- /dev/null
+++ b/Java-base/tiles/src/tiles-api/src/main/java/org/apache/tiles/AttributeContext.java
@@ -0,0 +1,171 @@
+/*
+ * $Id$
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you 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.tiles;
+
+import java.util.Map;
+import java.util.Set;
+
+/**
+ * Encapsulation of the current state of execution.
+ *
+ * @since Tiles 2.0
+ * @version $Rev$ $Date$
+ */
+public interface AttributeContext {
+
+ /**
+ * Returns the attribute that will be used to render a template.
+ *
+ * @return The template attribute.
+ * @since 2.1.2
+ */
+ Attribute getTemplateAttribute();
+
+ /**
+ * Sets the template attribute, that will be used to render the template
+ * page.
+ *
+ * @param templateAttribute The template attribute.
+ * @since 2.1.2
+ */
+ void setTemplateAttribute(Attribute templateAttribute);
+
+ /**
+ * Get associated preparer instance.
+ *
+ * @return The preparer name.
+ * @since 2.1.0
+ */
+ String getPreparer();
+
+ /**
+ * Set associated preparer instance.
+ *
+ * @param url The preparer name.
+ * @since 2.1.0
+ */
+ void setPreparer(String url);
+
+ /**
+ * Add all attributes to the context.
+ *
+ * @param newAttributes the attributes to be added.
+ */
+ void addAll(Map newAttributes);
+
+ /**
+ * Add all attributes to the context.
+ *
+ * @param defaultAttributes attributes which should be present.
+ */
+ void addMissing(Map defaultAttributes);
+
+ /**
+ * Copies the cascaded attributes to this attribute context.
+ *
+ * @param parent The parent context to be used.
+ * @since 2.1.0
+ */
+ void inheritCascadedAttributes(AttributeContext parent);
+
+ /**
+ * Copies all missing attributes from the parent attribute
+ * context to this one.
+ *
+ * @param parent The attribute context to copy attributes from.
+ * @since 2.1.0
+ */
+ void inherit(AttributeContext parent);
+
+ /**
+ * Retrieve the named attribute, either cascaded or not.
+ *
+ * @param name key name for the attribute.
+ * @return Attribute associated with the given name.
+ */
+ Attribute getAttribute(String name);
+
+ /**
+ * Retrieve the attribute that has been defined in this context (i.e. not
+ * cascaded).
+ *
+ * @param name key name for the attribute.
+ * @return Attribute The local attribute associated with the given name, if
+ * present, or null otherwise.
+ * @since 2.1.0
+ */
+ Attribute getLocalAttribute(String name);
+
+ /**
+ * Retrieve the attribute that has been cascaded at upper levels.
+ *
+ * @param name key name for the attribute.
+ * @return Attribute The cascaded attribute associated with the given name,
+ * if present, or null otherwise.
+ * @since 2.1.0
+ */
+ Attribute getCascadedAttribute(String name);
+
+ /**
+ * Returns the names of the local attributes, i.e. the one that have not
+ * been cascaded.
+ *
+ * @return The local attribute names.
+ * @since 2.1.0
+ */
+ Set getLocalAttributeNames();
+
+ /**
+ * Returns the names of the cascaded attributes.
+ *
+ * @return The cascaded attribute names.
+ * @since 2.1.0
+ */
+ Set getCascadedAttributeNames();
+
+ /**
+ * Add the specified attribute. The attribute value will be available only
+ * in the current context, i.e. it is like calling
+ * {@link AttributeContext#putAttribute(String, Attribute, boolean)} with
+ * cascade = false.
+ *
+ * @param name name of the attribute
+ * @param value value of the attribute
+ */
+ void putAttribute(String name, Attribute value);
+
+ /**
+ * Add the specified attribute.
+ *
+ * @param name name of the attribute
+ * @param value value of the attribute
+ * @param cascade If true, the attribute value will be
+ * available in all nested contexts. If false, it will be
+ * available only in the current context.
+ * @since 2.1.0
+ */
+ void putAttribute(String name, Attribute value, boolean cascade);
+
+ /**
+ * Clear the attributes.
+ */
+ void clear();
+}
diff --git a/Java-base/tiles/src/tiles-api/src/main/java/org/apache/tiles/BasicAttributeContext.java b/Java-base/tiles/src/tiles-api/src/main/java/org/apache/tiles/BasicAttributeContext.java
new file mode 100644
index 000000000..d6cfc7f67
--- /dev/null
+++ b/Java-base/tiles/src/tiles-api/src/main/java/org/apache/tiles/BasicAttributeContext.java
@@ -0,0 +1,471 @@
+/*
+ * $Id$
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you 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.tiles;
+
+import static org.apache.tiles.CompareUtil.*;
+
+import java.io.Serializable;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Set;
+
+
+/**
+ * Basic implementation for AttributeContext.
+ *
+ * @version $Rev$ $Date$
+ * @since 2.1.0
+ */
+public class BasicAttributeContext implements AttributeContext, Serializable {
+
+ /**
+ * The template attribute, to render a template.
+ *
+ * @since 2.1.2
+ */
+ protected Attribute templateAttribute;
+
+ /**
+ * Associated ViewPreparer URL or classname, if defined.
+ *
+ * @since 2.1.0
+ */
+ protected String preparer = null;
+
+ /**
+ * Template attributes.
+ * @since 2.1.0
+ */
+ protected Map attributes = null;
+
+ /**
+ * Cascaded template attributes.
+ * @since 2.1.0
+ */
+ protected Map cascadedAttributes = null;
+
+ /**
+ * Constructor.
+ *
+ * @since 2.1.0
+ */
+ public BasicAttributeContext() {
+ }
+
+ /**
+ * Constructor.
+ * Create a context and set specified attributes.
+ *
+ * @param attributes Attributes to initialize context.
+ * @since 2.1.0
+ */
+ public BasicAttributeContext(Map attributes) {
+ if (attributes != null) {
+ this.attributes = deepCopyAttributeMap(attributes);
+ }
+ }
+
+ /**
+ * Copy constructor.
+ *
+ * @param context The constructor to copy.
+ * @since 2.1.0
+ */
+ public BasicAttributeContext(AttributeContext context) {
+ if (context instanceof BasicAttributeContext) {
+ copyBasicAttributeContext((BasicAttributeContext) context);
+ } else {
+ Attribute parentTemplateAttribute = context.getTemplateAttribute();
+ if (parentTemplateAttribute != null) {
+ this.templateAttribute = new Attribute(parentTemplateAttribute);
+ }
+ this.preparer = context.getPreparer();
+ this.attributes = new HashMap();
+ Set