https://github.com/kwon37xi/jsp-template-inheritance
JSP layout with template inheritance.
https://github.com/kwon37xi/jsp-template-inheritance
Last synced: 3 months ago
JSON representation
JSP layout with template inheritance.
- Host: GitHub
- URL: https://github.com/kwon37xi/jsp-template-inheritance
- Owner: kwon37xi
- License: apache-2.0
- Created: 2013-09-09T14:41:10.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2015-11-14T08:50:41.000Z (over 9 years ago)
- Last Synced: 2023-08-05T08:52:34.667Z (almost 2 years ago)
- Language: Java
- Size: 269 KB
- Stars: 49
- Watchers: 12
- Forks: 15
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# JSP Template Inheritance
[](https://maven-badges.herokuapp.com/maven-central/kr.pe.kwonnam.jsp/jsp-template-inheritance)
With these template inheritance tag library you can manage template layouts.
You don't need to use layout frameworks like [Sitemesh](http://wiki.sitemesh.org/display/sitemesh/Home) or
[Apache Tiles](http://tiles.apache.org/).
If you use freemarker, refer to [freemarker-template-inheritance](https://github.com/kwon37xi/freemarker-template-inheritance).
From 0.3.RELEASE, you can download this library from the maven central repository.
### Gradle dependencies
```groovy
dependencies {
compile 'kr.pe.kwonnam.jsp:jsp-template-inheritance:0.3.RELEASE'
}
```
### Maven dependencies
```xml
kr.pe.kwonnam.jsp
jsp-template-inheritance
0.3.RELEASE
compile
```
## Usage
### web.xml
```xml
jsp-inheritance-prefix
/WEB-INF/layouts/
jsp-inheritance-suffix
.jsp
```
### /WEB-INF/layouts/base.jsp : layout
```jsp
<%@page contentType="text/html; charset=UTF-8" %>
<%@ taglib uri="http://kwonnam.pe.kr/jsp/template-inheritance" prefix="layout"%>
JSP Template Inheritance
Head
header
Contents
Contents will be placed under this h2
```
### view.jsp : contents
```jsp
<%@page contentType="text/html; charset=UTF-8" %>
<%@ taglib uri="http://kwonnam.pe.kr/jsp/template-inheritance" prefix="layout"%>
This is an example about layout management with JSP Template Inheritance
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin porta,
augue ut ornare sagittis, diam libero facilisis augue, quis accumsan enim velit a mauris.
Ut eleifend elit ante, sit amet suscipit leo lobortis eu. Quisque vitae lorem feugiat,
lacinia nulla eu, interdum eros. Ut dignissim tincidunt nisl ac iaculis.
Praesent consectetur arcu vitae tellus scelerisque venenatis.
Morbi vel leo eros. In id libero ultricies, laoreet enim et, tempor magna.
Vestibulum lorem velit, accumsan id purus at, lobortis fermentum diam.
Aenean nec placerat elit. Aenean vel sem arcu.
```
### PutType
1. APPEND : The put contents will be appended after block's contents. default.
1. PREPEND : The put contents will be prepended before block's contents.
1. REPLACE : The put contents will replace block's contents. The block's contents will be removed.
PutType vlaues are case insensitive.
### Layout path prefix/suffix
In web.xml you can set `jsp-inheritance-prefix` and `jsp-inheritance-suffix` context parameters.
The layout name will be prefixed and suffixed with these parameters.
When you set `jsp-inheritance-prefix` as `/WEB-INF/layouts/`, `jsp-ineheritance-suffix` as
`.jsp` and call `` the layout file URL will be `/WEB-INF/layouts/base.jsp`.
The prefix and suffix can be omitted.
### Example
`example` module is web application layout example. Run the module and browse .
Refer to `index.jsp`, `WEB-INF/layouts/base.jsp`, `WEB-INF/layouts/secondLayout.jsp`.
## Known problems
1. If you want to pass a variable from a child page to it's layout page, the variable must be added to **REQUEST scope**.
## Project Development
### Intellij
```
./gradlew cleanIdea idea
```
### Eclipse
```
./gradlew cleanEclipse eclipse
```
## Reference
1. [freemarker-template-inheritance](https://github.com/kwon37xi/freemarker-template-inheritance)