search
HomeJavajavaTutorialUsing FreeMarker for Web template engine processing in Java API development

Using FreeMarker for Web template engine processing in Java API development

Jun 18, 2023 am 08:39 AM
freemarkerjava apiweb template engine.

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:

  1. 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.
  2. 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.
  3. Various template file formats: FreeMarker supports the processing of multiple template file formats, including, but not limited to, HTML, XML, and JSON.
  4. 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.

  1. 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>
  1. 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.

  1. 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.

  1. 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.

  1. 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:

  1. ${...}: FreeMarker expressions can contain any legal Java expression.
  2. : Contains original template tags.
  3. ..@>: Indicates an aggregate template fragment.
  4. #...#list..#assign...#recover...#stop: The original tag for operating and controlling template instances.
  5. ...#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.

  1. 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.

  1. 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");
List userList = 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!

Statement
The content of this article is voluntarily contributed by netizens, and the copyright belongs to the original author. This site does not assume corresponding legal responsibility. If you find any content suspected of plagiarism or infringement, please contact admin@php.cn
Why can't JavaScript directly obtain hardware information on the user's computer?Why can't JavaScript directly obtain hardware information on the user's computer?Apr 19, 2025 pm 08:15 PM

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...

Circular dependencies appear in the RuoYi framework. How to troubleshoot and solve the problem of dynamicDataSource Bean?Circular dependencies appear in the RuoYi framework. How to troubleshoot and solve the problem of dynamicDataSource Bean?Apr 19, 2025 pm 08:12 PM

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...

When building a microservice architecture using Spring Cloud Alibaba, do you have to manage each module in a parent-child engineering structure?When building a microservice architecture using Spring Cloud Alibaba, do you have to manage each module in a parent-child engineering structure?Apr 19, 2025 pm 08:09 PM

About SpringCloudAlibaba microservices modular development using SpringCloud...

Treatment of x² in curve integral: Why can the standard answer be ignored (1/3) x³?Treatment of x² in curve integral: Why can the standard answer be ignored (1/3) x³?Apr 19, 2025 pm 08:06 PM

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...

What should I do if the Redis cache of OAuth2Authorization object fails in Spring Boot?What should I do if the Redis cache of OAuth2Authorization object fails in Spring Boot?Apr 19, 2025 pm 08:03 PM

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

Why can't the main class be found after copying and pasting the package in IDEA? Is there any solution?Why can't the main class be found after copying and pasting the package in IDEA? Is there any solution?Apr 19, 2025 pm 07:57 PM

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

Java multi-interface call: How to ensure that interface A is executed before interface B is executed?Java multi-interface call: How to ensure that interface A is executed before interface B is executed?Apr 19, 2025 pm 07:54 PM

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...

See all articles

Hot AI Tools

Undresser.AI Undress

Undresser.AI Undress

AI-powered app for creating realistic nude photos

AI Clothes Remover

AI Clothes Remover

Online AI tool for removing clothes from photos.

Undress AI Tool

Undress AI Tool

Undress images for free

Clothoff.io

Clothoff.io

AI clothes remover

Video Face Swap

Video Face Swap

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

Hot Tools

Atom editor mac version download

Atom editor mac version download

The most popular open source editor

SublimeText3 Linux new version

SublimeText3 Linux new version

SublimeText3 Linux latest version

SublimeText3 Mac version

SublimeText3 Mac version

God-level code editing software (SublimeText3)

SublimeText3 English version

SublimeText3 English version

Recommended: Win version, supports code prompts!

SAP NetWeaver Server Adapter for Eclipse

SAP NetWeaver Server Adapter for Eclipse

Integrate Eclipse with SAP NetWeaver application server.