🤹🏽 🚆 🤦🏾 FreeMarker टेम्पलेट्स 👩🏻‍🌾 💼 🤾

Apache FreeMarker एक टेम्प्लेट इंजन है: टेक्स्ट आउटपुट जेनरेट करने के लिए जावा लाइब्रेरी (HTML पेज, xml, कॉन्फिगरेशन फाइल्स, सोर्स कोड आदि) इनपुट के लिए एक टेम्प्लेट भेजा जाता है, उदाहरण के लिए, html जिसमें विशेष एक्सप्रेशन होते हैं, इस एक्सप्रेशन के अनुरूप डेटा तैयार किया जाता है, और फ्रीडमर गतिशील रूप से इस डेटा को सम्मिलित करता है और आपको एक गतिशील रूप से आबादी वाला दस्तावेज़ मिलता है।

FreeMarker लेख में
वसंत का बूट
मैक्रो
अन्य एपीआई

यानी फ्रीमार्कर पर एक सरल अभिव्यक्ति $ {name} उदाहरण के लिए है, भाव गणना, तुलना संचालन, स्थितियों, छोरों, सूचियों, अंतर्निहित कार्यों, मैक्रोज़ और कई अन्य लोगों का समर्थन करते हैं। उदाहरण html एक्सप्रेशन $ {name} (टेम्पलेट test.ftl) के साथ:

<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>${name}!</title> </head> <body> <h2>Hello ${name}!</h2> </body> </html>

यदि आप अब जावा में एक डेटा मॉडल बनाते हैं:

 import freemarker.template.Configuration; import freemarker.template.Template; ... //  Configuration cfg = new Configuration(Configuration.VERSION_2_3_27); //   Map<String, Object> root = new HashMap<>(); root.put("name", "Freemarker"); //  Template temp = cfg.getTemplate("test.ftl"); //      Writer out = new OutputStreamWriter(System.out); //    temp.process(root, out);

तब हमें भरे हुए नाम के साथ एक HTML दस्तावेज़ मिलता है।

यदि आपको सूची को संसाधित करने की आवश्यकता है, तो # सूची निर्माण का उपयोग किया जाता है, उदाहरण के लिए HTML सूची:

 <ul> <#list father as item> <li>${item}</li> </#list> </ul>

जावा में, आप डेटा मॉडल को निम्नानुसार सूचीबद्ध कर सकते हैं

 Map<String, Object> root = new HashMap<>(); .... root.put("father", Arrays.asList("Alexander", "Petrov", 47));

चलिए वसंत पर चलते हैं

स्प्रिंग बूट में फ्रीडमर सपोर्ट है। SPRING INITIALIZR साइट पर आप pom प्रोजेक्ट फाइल प्राप्त कर सकते हैं।

पोम फाइल

 <?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.example</groupId> <artifactId>demoFreeMarker</artifactId> <version>0.0.1-SNAPSHOT</version> <packaging>jar</packaging> <name>demoFreeMarker</name> <description>Demo project for Spring Boot</description> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.0.4.RELEASE</version> <relativePath/> <!-- lookup parent from repository --> </parent> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding> <java.version>1.8</java.version> </properties> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-freemarker</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-devtools</artifactId> <scope>runtime</scope> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> </project>

क्लास डेमोफ्रीमैकर एपेलेशन

 @SpringBootApplication public class DemoFreeMarkerApplication { public static void main(String[] args) { SpringApplication.run(DemoFreeMarkerApplication.class, args); } }

स्प्रिंग में फ़्रीमार्कर के लिए पूर्व-कॉन्फ़िगर कॉन्फ़िगरेशन घटक है। एक उदाहरण कंसोल एप्लिकेशन के लिए, मैं कमांड लाइन (कमांडलाइनरनर) को संसाधित करने के लिए स्प्रिंग इंटरफ़ेस लूंगा और निम्नलिखित ftl टेम्पलेट (hello_test.ftl) के लिए डेटा मॉडल तैयार करूंगा:

हैलो_स्टेस्ट.फ्लैटल टेम्पलेट

 <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Hello ${name}!</title> </head> <body> <input type="text" placeholder="${name}"> <table> <#list persons as row> <tr> <#list row as field> <td>${field}</td> </#list> </tr> </#list> </table> </body> </html>

Hello_test.ftl टेम्प्लेट डेटा मॉडल के लिए जावा कोड:

कमांडलाइन क्लास और डेटा मॉडल

 @Component public class CommandLine implements CommandLineRunner { @Autowired private Configuration configuration; public void run(String... args) { Map<String, Object> root = new HashMap<>(); //  ${name} root.put("name", "Fremarker"); //  <#list persons List<List> persons = new ArrayList<>(); persons.add(Arrays.asList("Alexander", "Petrov", 47)); persons.add(Arrays.asList("Slava", "Petrov", 13)); root.put("persons", persons); try { Template template = configuration.getTemplate("hello_test.ftl"); Writer out = new OutputStreamWriter(System.out); try { template.process(root, out); } catch (TemplateException e) { e.printStackTrace(); } } catch (IOException e) { e.printStackTrace(); } } }

प्रसंस्करण के बाद हमें एक HTML दस्तावेज़ मिलता है:

आउटपुट HTML

 <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Hello Fremarker!</title> </head> <body> <input type="text" placeholder="Fremarker"> <table> <tr> <td>Alexander</td> <td>Petrov</td> <td>47</td> </tr> <tr> <td>Slava</td> <td>Petrov</td> <td>13</td> </tr> </table> </body>

मैक्रो

फ्रीमॉकर के पास मैक्रो समर्थन है, यह बहुत सुविधाजनक और मजबूत है, और इसका उपयोग करना बिल्कुल आवश्यक है।

एक सरल उदाहरण:

 <#macro textInput id value=""> <input type="text" id="${id}" value="${value}"> </#macro>

यह textInput और पैरामीटर्स आईडी (यह आवश्यक है) और मान (यह आवश्यक नहीं है, क्योंकि इसका डिफ़ॉल्ट रूप है) नाम के साथ एक मैक्रो है। अगला उसका शरीर और इनपुट मापदंडों का उपयोग है। टेम्पलेट में, मैक्रो फ़ाइल निम्नानुसार है:

 <#import "ui.ftl" as ui/>

टेम्पलेट से, मैक्रो को इस तरह कहा जाता है:

 <@ui.textInput id="name" value="${name}"/>

कहां ui वह उपनाम है जिसे कनेक्ट करते समय निर्दिष्ट किया गया था, $ {name} मॉडल में एक चर है, फिर उपनाम के माध्यम से हम मैक्रो नाम textInput का उल्लेख करते हैं और इसके मापदंडों को निर्दिष्ट करते हैं, कम से कम अनिवार्य। मैं html इनपुट और टेबल के लिए सरल मैक्रो तैयार करूंगा:

ui.ftl मैक्रो फ़ाइल

 <#-- textInput macro for html input --> <#macro textInput id placeholder="" value=""> <input type="text" id="${id}" placeholder="${placeholder}" value="${value}"> </#macro> <#-- table macro for html table --> <#macro table id rows> <table id="${id}"> <#list rows as row> <tr> <td>${row?index + 1}</td> <#list row as field> <td>${field}</td> </#list> </tr> </#list> </table> </#macro>

$ {पंक्ति; सूचकांक + 1} एक सूची आइटम के सूचकांक के लिए अंतर्निहित समर्थन है; यदि हम अब पिछले मुख्य टेम्पलेट को बदलते हैं और मैक्रोज़ के साथ इनपुट और टेबल को प्रतिस्थापित करते हैं, तो हमें निम्नलिखित दस्तावेज़ मिलते हैं:

हेल्लो.फटल टेम्पलेट

 <#import "ui.ftl" as ui/> <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Hello ${name}!</title> </head> <body> <@ui.textInput id="name" placeholder="Enter name" value="${name}"/> <@ui.table id="table1" rows=persons/> </body> </html>

बाकी

बेशक, इस तरह के एक मॉडल एक वेब अनुप्रयोग में उपयोग करने के लिए सुविधाजनक है। मैं पोम में निर्भरता को जोड़ता हूं:

  <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>

अन्य नियंत्रक जोड़ें:

DemoController.java

 @Controller public class DemoController { @Autowired private RepositoryService repositoryService; @GetMapping("/") public String index() { return "persons"; } @RequestMapping(value = "/search", method = RequestMethod.POST) public String hello(Model model, @RequestParam(defaultValue = "") String searchName) { List<List<String>> persons = repositoryService.getRepository(); List<List<String>> filterList = persons.stream() .filter(p -> p.get(0).contains(searchName)) .collect(Collectors.toList()); model.addAttribute("persons", filterList); model.addAttribute("lastSearch", searchName); return "persons"; } @RequestMapping(value = "/save", method = RequestMethod.POST) public String save(Model model, @ModelAttribute("person") Person person) { List<List<String>> persons = repositoryService.addPerson(person); model.addAttribute("persons", persons); return "persons"; } }

व्यक्तियों के लिए सेवा भंडार:

RepositoryService.java

 @Service public class RepositoryService { private static List<List<String>> repository = new ArrayList<>(); public List<List<String>> getRepository() { return repository; } public List<List<String>> addPerson(Person person) { repository.add(Arrays.asList(person.getFirstName(), person.getAge().toString())); return repository; } }

चेहरा वर्ग:

Person.java

 public class Person { public Person(String firstName, Integer age) { this.firstName = firstName; this.age = age; } private String firstName; private Integer age; public String getFirstName() { return firstName; } public Integer getAge() { return age; } }

मैक्रो टेम्पलेट:

ui.ftl

 <#macro formInput id name label type="text" value=""> <label for="${id}">${label}</label> <input type="${type}" id="${id}" name="${name}" value="${value}"> </#macro> <#macro table id rows> <table id="${id}" border="1px" cellspacing="2" border="1" cellpadding="5"> <#list rows as row> <tr> <td>${row?index + 1}</td> <#list row as field> <td>${field}</td> </#list> </tr> </#list> </table> </#macro>

मुख्य टेम्पलेट:

persons.ftl

 <#import "ui.ftl" as ui/> <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Person</title> <link href="style/my.css" rel="stylesheet"> </head> <body> <div> <fieldset> <legend> </legend> <form name="person" action="save" method="POST"> <@ui.formInput id="t1" name="firstName" label=""/> <br/> <@ui.formInput id="t2" name="age" label=""/> <br/> <input type="submit" value="Save" /> </form> </fieldset> </div> <div> <fieldset> <legend></legend> <form name="searchForm" action="search" method="POST"> <@ui.formInput id="t3" name="searchName" label=""/> <br/> <input type="submit" value="Search" /> </form> </fieldset> </div> <p><#if lastSearch??> : ${lastSearch}<#else></#if></p> <@ui.table id="table1" rows=persons![]/> </body> </html>

परियोजना संरचना:

एप्लिकेशन दो कमांड "सेव" करेगा और चेहरे की "खोज" (नियंत्रक देखें)। स्प्रिंग द्वारा इनपुट मापदंडों के प्रसंस्करण (मानचित्रण) पर सभी कार्य किए जाते हैं।

टेम्पलेट के लिए कुछ स्पष्टीकरण।

 <#if lastSearch??> : ${lastSearch}<#else></#if>

यह जाँचता है कि यदि पैरामीटर सेट है, तो "" खोजें: .. "वाक्यांश प्रदर्शित करें, अन्यथा कुछ भी नहीं:

 <@ui.table id="table1" rows=persons![]/>

यहां भी, एक चेक बनाया गया था कि व्यक्तियों की सूची मौजूद है, अन्यथा यह खाली है। जब आप पहली बार पृष्ठ खोलते हैं तो ये चेक महत्वपूर्ण होते हैं, अन्यथा आपको उन्हें सूचकांक (), नियंत्रक में प्रारंभ करना होगा।

आवेदन का काम

सामग्री:

→ अपाचे फ्रीमकर मैनुअल

FreeMarker टेम्पलेट्स

चलिए वसंत पर चलते हैं

मैक्रो

बाकी

More articles: