Using FreeMarker for Web template engine processing in Java API development
With the rapid development of the Internet, the development of Web applications has become more and more common. To make web applications more readable and maintainable, developers often use web template engines for view rendering. In Java development, there are many popular web template engines, and FreeMarker is one of them.
This article will introduce the FreeMarker Web template engine and its use in Java API development, including its core features, configuration and its application in actual combat.
1. What is FreeMarker
FreeMarker is an open source Java template engine that uses a template-based method to generate static text or dynamic web pages. Its feature is the separation of templates and program code, which clarifies the boundaries between performance and logic, separates page rendering and business logic, and improves the readability and maintainability of the code. FreeMarker supports multiple template types such as text templates, XML templates, HTML templates, JSP tag libraries, etc., and can be integrated with a variety of web frameworks, such as Struts2, Spring MVC, etc.
FreeMarker has the following features:
- Separation of concerns: The template file only defines the display effect of the page and the interactive behavior of front-end users, without embedded business logic code.
- Strong type support: Compared with JSP, FreeMarker has strong type support capabilities, which can help us check type errors at compile time and reduce runtime errors.
- Various template file formats: FreeMarker supports the processing of multiple template file formats, including, but not limited to, HTML, XML, and JSON.
- Compatibility: FreeMarker can be integrated into various web frameworks and is widely used in SpringMVC, Struts2 and other frameworks.
2. Use of FreeMarker API
FreeMarker provides many APIs to use it to generate templates. Our initial call involves configuring FreeMarker to emit templates. Next, we show how to set up and use the FreeMarker API.
- Introducing FreeMarker’s dependency package
First, we need to add FreeMarker’s dependency in the project’s pom.xml file:
<dependency> <groupId>org.freemarker</groupId> <artifactId>freemarker</artifactId> <version>2.3.31</version> </dependency>
- Configuring FreeMarker
To create FreeMarker or you need a configuration to tell it how to load the template, refer to the following code example:
Configuration configuration = new Configuration(Configuration.VERSION_2_3_28); configuration.setClassForTemplateLoading(YourClass.class, "templates");
Among them, VERSION_2_3_28 is the FreeMarker version number, setClassForTemplateLoading() Method sets the path for FreeMarker to load templates.
- Set the data model
Next, you need to set the input data of the template. In FreeMarker, this background is a Map, and this Map needs to contain all the data we want to use in the template. We can use the SimpleHash type to create this Map:
Map<String, Object> input = new HashMap<String, Object>(); input.put("title", "FreeMarker Example");
In this example, we added "title" as the key and "FreeMarker Example" as the value to the input.
- Load and render the template
Finally, we need to load the template and render the input data into the template, refer to the following code example:
Template template = configuration.getTemplate("example.ftl"); Writer out = new OutputStreamWriter(System.out); template.process(input, out); out.flush();
In this example, "example.ftl" is a template file. We use the configuration.getTemplate() method to load it, and the template.process() method to render the data in the input into the template, and finally output it through out.
- FreeMarker template syntax
FreeMarker template syntax defines template tags, built-in formats, and methods. Template markers are directives in templates, consisting of FreeMarker template code in a pair of ${} or tags.
The following are some FreeMarker markers:
- ${...}: FreeMarker expressions can contain any legal Java expression.
- : Contains original template tags.
- ..@>: Indicates an aggregate template fragment.
- #...#list..#assign...#recover...#stop: The original tag for operating and controlling template instances.
- ...#macro>: Define a reusable template block.
3. Application examples of FreeMarker
Below we will demonstrate how to use FreeMarker to write templates in Java API development.
- Write template file
First, we need to write a FreeMarker template file, for example, test.ftl:
<html> <head> <title>${title}</title> </head> <body> <h1 id="title">${title}</h1> <ul> <#list users as user> <li>${user.name} (${user.email})</li> </#list> </ul> </body> </html>
In this example, we Use the ${...} tag to reference the data in the input, and use the #list> tag to loop through users and get the name and email attributes from each user.
- Set the data model and load the template
Then, we need to set the data model, refer to the following code example:
Map<String, Object> input = new HashMap<String, Object>(); input.put("title", "FreeMarker Example"); ListuserList = new ArrayList (); userList.add(new User("Tom", "tom@example.com")); userList.add(new User("Jerry", "jerry@example.com")); input.put("users", userList); Configuration configuration = new Configuration(Configuration.VERSION_2_3_28); configuration.setClassForTemplateLoading(YourClass.class, "/templates"); Template template = configuration.getTemplate("test.ftl"); Writer out = new OutputStreamWriter(System.out); template.process(input, out); out.flush();
In this example, we A JavaBean class named User is created. When creating the Map, we use userList as the key and the List reference as the value, and add it to the input.
3. Summary
This article introduces the FreeMarker Web template engine and its use in Java API development. FreeMarker makes web application development easier while improving code readability and maintainability. By explaining the core features, configuration and application of FreeMarker in practice, we hope to help readers better understand and apply FreeMarker.
The above is the detailed content of Using FreeMarker for Web template engine processing in Java API development. For more information, please follow other related articles on the PHP Chinese website!

Discussion on the reasons why JavaScript cannot obtain user computer hardware information In daily programming, many developers will be curious about why JavaScript cannot be directly obtained...

RuoYi framework circular dependency problem troubleshooting and solving the problem of circular dependency when using RuoYi framework for development, we often encounter circular dependency problems, which often leads to the program...

About SpringCloudAlibaba microservices modular development using SpringCloud...

Questions about a curve integral This article will answer a curve integral question. The questioner had a question about the standard answer to a sample question...

In SpringBoot, use Redis to cache OAuth2Authorization object. In SpringBoot application, use SpringSecurityOAuth2AuthorizationServer...

JDBC...

Why can't the main class be found after copying and pasting the package in IDEA? Using IntelliJIDEA...

State synchronization between Java multi-interface calls: How to ensure that interface A is called after it is executed? In Java development, you often encounter multiple calls...


Hot AI Tools

Undresser.AI Undress
AI-powered app for creating realistic nude photos

AI Clothes Remover
Online AI tool for removing clothes from photos.

Undress AI Tool
Undress images for free

Clothoff.io
AI clothes remover

Video Face Swap
Swap faces in any video effortlessly with our completely free AI face swap tool!

Hot Article

Hot Tools

Atom editor mac version download
The most popular open source editor

SublimeText3 Linux new version
SublimeText3 Linux latest version

SublimeText3 Mac version
God-level code editing software (SublimeText3)

SublimeText3 English version
Recommended: Win version, supports code prompts!

SAP NetWeaver Server Adapter for Eclipse
Integrate Eclipse with SAP NetWeaver application server.