Struts 2 - ตัวอย่างสวัสดีชาวโลก

ดังที่คุณได้เรียนรู้แล้วจากสถาปัตยกรรม Struts 2 เมื่อคุณคลิกที่ไฮเปอร์ลิงก์หรือส่งแบบฟอร์ม HTML ในเว็บแอปพลิเคชัน Struts 2 อินพุตจะถูกรวบรวมโดยคอนโทรลเลอร์ซึ่งส่งไปยังคลาส Java ที่เรียกว่า Actions หลังจากดำเนินการดำเนินการผลลัพธ์จะเลือกทรัพยากรที่จะแสดงผลการตอบกลับ โดยทั่วไปทรัพยากรเป็น JSP แต่ยังสามารถเป็นไฟล์ PDF สเปรดชีต Excel หรือหน้าต่างแอพเพล็ต Java

สมมติว่าคุณได้สร้างสภาพแวดล้อมการพัฒนาของคุณแล้ว ตอนนี้ให้เราดำเนินการสร้างอาคารแรกของเราHello World Struts2โครงการ. จุดมุ่งหมายของโครงการนี้คือการสร้างเว็บแอปพลิเคชันที่รวบรวมชื่อผู้ใช้และแสดง "Hello World" ตามด้วยชื่อผู้ใช้

เราจะต้องสร้างองค์ประกอบสี่อย่างต่อไปนี้สำหรับโครงการ Struts 2 ใด ๆ -

ซีเนียร์ No	ส่วนประกอบและคำอธิบาย
1	Action สร้างคลาสการดำเนินการซึ่งจะมีตรรกะทางธุรกิจที่สมบูรณ์และควบคุมการโต้ตอบระหว่างผู้ใช้โมเดลและมุมมอง
2	Interceptors สร้างเครื่องสกัดกั้นหากจำเป็นหรือใช้เครื่องสกัดกั้นที่มีอยู่ นี่เป็นส่วนหนึ่งของ Controller
3	View สร้าง JSP เพื่อโต้ตอบกับผู้ใช้เพื่อรับอินพุตและนำเสนอข้อความสุดท้าย
4	Configuration Files สร้างไฟล์คอนฟิกูเรชันเพื่อจับคู่ Action, View และ Controllers ไฟล์เหล่านี้คือ struts.xml, web.xml, struts.properties

ฉันจะใช้ Eclipse IDE เพื่อให้ส่วนประกอบที่จำเป็นทั้งหมดถูกสร้างขึ้นภายใต้ Dynamic Web Project เริ่มต้นด้วยการสร้าง Dynamic Web Project

สร้างโครงการเว็บแบบไดนามิก

เริ่ม Eclipse ของคุณแล้วไปด้วย File > New > Dynamic Web Project และป้อนชื่อโครงการเป็น HelloWorldStruts2 และตั้งค่าตัวเลือกที่เหลือตามที่ระบุในหน้าจอต่อไปนี้ -

เลือกตัวเลือกเริ่มต้นทั้งหมดในหน้าจอถัดไปและสุดท้ายตรวจสอบ Generate Web.xml deployment descriptorตัวเลือก สิ่งนี้จะสร้างโครงการเว็บแบบไดนามิกสำหรับคุณใน Eclipse ตอนนี้ไปกับWindows > Show View > Project Explorerและคุณจะเห็นหน้าต่างโครงการของคุณดังต่อไปนี้ -

ตอนนี้คัดลอกไฟล์ต่อไปนี้จากโฟลเดอร์ struts 2 lib C:\struts-2.2.3\lib ไปยังโครงการของเรา WEB-INF\libโฟลเดอร์ ในการดำเนินการนี้คุณสามารถลากและวางไฟล์ต่อไปนี้ทั้งหมดลงในโฟลเดอร์ WEB-INF \ lib

commons-fileupload-x.y.z.jar
commons-io-x.y.z.jar
commons-lang-x.y.jar
commons-logging-x.y.z.jar
commons-logging-api-x.y.jar
freemarker-x.y.z.jar
javassist-.xy.z.GA
ognl-x.y.z.jar
struts2-core-x.y.z.jar
xwork-core.x.y.z.jar

สร้างคลาสการดำเนินการ

คลาสการดำเนินการเป็นกุญแจสำคัญในแอปพลิเคชัน Struts 2 และเราใช้ตรรกะทางธุรกิจส่วนใหญ่ในคลาสแอ็คชั่น ให้เราสร้างไฟล์ java HelloWorldAction.java ภายใต้Java Resources > src ด้วยชื่อแพ็คเกจ com.tutorialspoint.struts2 ด้วยเนื้อหาที่ระบุด้านล่าง

คลาส Action ตอบสนองต่อการกระทำของผู้ใช้เมื่อผู้ใช้คลิก URL เมธอดของคลาส Action อย่างน้อยหนึ่งตัวถูกเรียกใช้งานและผลลัพธ์ String จะถูกส่งกลับ ขึ้นอยู่กับค่าของผลลัพธ์เพจ JSP เฉพาะจะถูกแสดงผล

package com.tutorialspoint.struts2;

public class HelloWorldAction {
   private String name;

   public String execute() throws Exception {
      return "success";
   }
   
   public String getName() {
      return name;
   }

   public void setName(String name) {
      this.name = name;
   }
}

นี่เป็นคลาสที่เรียบง่ายมากที่มีคุณสมบัติหนึ่งที่เรียกว่า "ชื่อ" เรามี getters มาตรฐานและวิธี setter สำหรับคุณสมบัติ "name" และวิธีการดำเนินการที่ส่งคืนสตริง "success"

กรอบงาน Struts 2 จะสร้างวัตถุของ HelloWorldActionคลาสและเรียกใช้เมธอดที่เรียกใช้เพื่อตอบสนองต่อการกระทำของผู้ใช้ คุณใส่ตรรกะทางธุรกิจของคุณไว้ในวิธีนี้ซึ่งสุดท้ายจะส่งคืนค่าคงที่ของสตริง กล่าวอีกนัยหนึ่งสำหรับแต่ละ URL คุณจะต้องใช้คลาสแอ็คชันหนึ่งคลาสและคุณสามารถใช้ชื่อคลาสนั้นโดยตรงเป็นชื่อแอ็คชันของคุณหรือคุณสามารถแมปกับชื่ออื่นโดยใช้ไฟล์ struts.xml ดังที่แสดงด้านล่าง

สร้างมุมมอง

เราต้องการ JSP เพื่อนำเสนอข้อความสุดท้ายหน้านี้จะถูกเรียกโดยเฟรมเวิร์ก Struts 2 เมื่อการกระทำที่กำหนดไว้ล่วงหน้าจะเกิดขึ้นและการแมปนี้จะถูกกำหนดในไฟล์ struts.xml ให้เราสร้างไฟล์ jsp ด้านล่างHelloWorld.jspในโฟลเดอร์ WebContent ในโปรเจ็กต์ eclipse ของคุณ ในการดำเนินการนี้ให้คลิกขวาที่โฟลเดอร์ WebContent ใน project explorer และเลือกNew >JSP File.

<%@ page contentType = "text/html; charset = UTF-8" %>
<%@ taglib prefix = "s" uri = "/struts-tags" %>

<html>
   <head>
      <title>Hello World</title>
   </head>
   
   <body>
      Hello World, <s:property value = "name"/>
   </body>
</html>

คำสั่ง taglib บอกคอนเทนเนอร์ Servlet ว่าหน้านี้จะใช้ไฟล์ Struts 2 แท็กและแท็กเหล่านี้จะนำหน้าด้วย s.

แท็ก s: property แสดงค่าของ action class property "name> ซึ่งส่งคืนโดยเมธอด getName() ของคลาส HelloWorldAction

สร้างหน้าหลัก

เรายังต้องสร้าง index.jspในโฟลเดอร์ WebContent ไฟล์นี้จะทำหน้าที่เป็น URL การดำเนินการเริ่มต้นที่ผู้ใช้สามารถคลิกเพื่อบอกให้เฟรมเวิร์ก Struts 2 เรียกเมธอดที่กำหนดไว้ของคลาส HelloWorldAction และแสดงมุมมอง HelloWorld.jsp

<%@ page language = "java" contentType = "text/html; charset = ISO-8859-1"
   pageEncoding = "ISO-8859-1"%>
<%@ taglib prefix = "s" uri = "/struts-tags"%>
   <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd">

<html>
   <head>
      <title>Hello World</title>
   </head>
   
   <body>
      <h1>Hello World From Struts2</h1>
      <form action = "hello">
         <label for = "name">Please enter your name</label><br/>
         <input type = "text" name = "name"/>
         <input type = "submit" value = "Say Hello"/>
      </form>
   </body>
</html>

helloการดำเนินการที่กำหนดไว้ในไฟล์มุมมองด้านบนจะแมปกับคลาส HelloWorldAction และวิธีการดำเนินการโดยใช้ไฟล์ struts.xml เมื่อผู้ใช้คลิกที่ปุ่มส่งจะทำให้เฟรมเวิร์ก Struts 2 รันเมธอดที่กำหนดไว้ในคลาส HelloWorldAction และขึ้นอยู่กับค่าที่ส่งคืนของเมธอดมุมมองที่เหมาะสมจะถูกเลือกและแสดงผลเป็นการตอบสนอง

ไฟล์การกำหนดค่า

เราต้องมีการแมปเพื่อผูก URL คลาส HelloWorldAction (โมเดล) และ HelloWorld.jsp (มุมมอง) เข้าด้วยกัน การแม็ปจะบอกเฟรมเวิร์ก Struts 2 ว่าคลาสใดจะตอบสนองต่อการกระทำของผู้ใช้ (URL) วิธีการของคลาสนั้นจะถูกเรียกใช้และมุมมองใดที่จะแสดงผลตามผลลัพธ์ของสตริงที่เมธอดส่งคืน

ดังนั้นให้เราสร้างไฟล์ชื่อ struts.xml. เนื่องจาก Struts 2 ต้องการให้ struts.xml อยู่ในโฟลเดอร์คลาส ดังนั้นสร้างไฟล์ struts.xml ภายใต้โฟลเดอร์ WebContent / WEB-INF / คลาส Eclipse ไม่ได้สร้างโฟลเดอร์ "คลาส" ตามค่าเริ่มต้นดังนั้นคุณต้องดำเนินการนี้ด้วยตัวเอง ในการดำเนินการนี้ให้คลิกขวาที่โฟลเดอร์ WEB-INF ใน project explorer และเลือกNew > Folder. struts.xml ของคุณควรมีลักษณะดังนี้ -

<?xml version = "1.0" Encoding = "UTF-8"?>
<!DOCTYPE struts PUBLIC
   "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
   "http://struts.apache.org/dtds/struts-2.0.dtd">

<struts>
   <constant name = "struts.devMode" value = "true" />
   
   <package name = "helloworld" extends = "struts-default">
     <action name = "hello" 
         class = "com.tutorialspoint.struts2.HelloWorldAction" 
         method = "execute">
         <result name = "success">/HelloWorld.jsp</result>
      </action>
   </package>
</struts>

คำไม่กี่คำที่ต้องเข้าใจเกี่ยวกับไฟล์กำหนดค่าข้างต้น ที่นี่เราตั้งค่าคงที่struts.devMode ถึง trueเนื่องจากเรากำลังทำงานในสภาพแวดล้อมการพัฒนาและเราจำเป็นต้องเห็นข้อความบันทึกที่เป็นประโยชน์ จากนั้นเรากำหนดแพ็คเกจที่เรียกว่าhelloworld.

การสร้างแพ็คเกจมีประโยชน์เมื่อคุณต้องการรวมกลุ่มการกระทำของคุณเข้าด้วยกัน ในตัวอย่างของเราเราตั้งชื่อการกระทำของเราว่า "สวัสดี" ซึ่งสอดคล้องกับ URL/hello.action และได้รับการสำรองข้อมูลโดยไฟล์HelloWorldAction.class. execute วิธีการของ HelloWorldAction.class เป็นวิธีการที่เรียกใช้เมื่อ URL /hello.actionถูกเรียกใช้ หากผลลัพธ์ของวิธีการดำเนินการส่งกลับ "สำเร็จ" เราจะนำผู้ใช้ไปที่HelloWorld.jsp.

ขั้นตอนต่อไปคือการสร้างไฟล์ web.xmlไฟล์ซึ่งเป็นจุดเริ่มต้นสำหรับการร้องขอไปยัง Struts 2 จุดเริ่มต้นของแอ็พพลิเคชัน Struts2 จะเป็นตัวกรองที่กำหนดไว้ในตัวอธิบายการปรับใช้ (web.xml) ดังนั้นเราจะกำหนดรายการของคลาส org.apache.struts2.dispatcher.FilterDispatcher ใน web.xml ต้องสร้างไฟล์ web.xml ภายใต้โฟลเดอร์ WEB-INF ภายใต้ WebContent Eclipse ได้สร้างไฟล์ skeleton web.xml สำหรับคุณแล้วเมื่อคุณสร้างโปรเจ็กต์ ดังนั้นให้แก้ไขได้ดังนี้ -

<?xml version = "1.0" Encoding = "UTF-8"?>
<web-app xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
   xmlns = "http://java.sun.com/xml/ns/javaee" 
   xmlns:web = "http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
   xsi:schemaLocation = "http://java.sun.com/xml/ns/javaee 
   http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
   id = "WebApp_ID" version = "3.0">
   
   <display-name>Struts 2</display-name>
   
   <welcome-file-list>
      <welcome-file>index.jsp</welcome-file>
   </welcome-file-list>
   
   <filter>
      <filter-name>struts2</filter-name>
      <filter-class>
         org.apache.struts2.dispatcher.FilterDispatcher
      </filter-class>
   </filter>

   <filter-mapping>
      <filter-name>struts2</filter-name>
      <url-pattern>/*</url-pattern>
   </filter-mapping>
</web-app>

เราได้ระบุให้ index.jsp เป็นไฟล์ต้อนรับของเรา จากนั้นเราได้กำหนดค่าตัวกรอง Struts2 ให้ทำงานบน URL ทั้งหมด (เช่น url ใด ๆ ที่ตรงกับรูปแบบ / *)

เพื่อเปิดใช้งานบันทึกโดยละเอียด

คุณสามารถเปิดใช้งานฟังก์ชันการบันทึกที่สมบูรณ์ในขณะที่ทำงานกับ Struts 2 ได้โดยการสร้าง logging.properties ไฟล์ภายใต้ WEB-INF/classesโฟลเดอร์ เก็บสองบรรทัดต่อไปนี้ไว้ในไฟล์คุณสมบัติของคุณ -

org.apache.catalina.core.ContainerBase.[Catalina].level = INFO
org.apache.catalina.core.ContainerBase.[Catalina].handlers = \
   java.util.logging.ConsoleHandler

logging.properties ดีฟอลต์ระบุ ConsoleHandler สำหรับการกำหนดเส้นทางการบันทึกไปยัง stdout และ FileHandler สามารถตั้งค่าขีด จำกัด ระดับการบันทึกของตัวจัดการได้โดยใช้ SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST หรือ ALL

แค่นั้นแหละ. เราพร้อมที่จะเรียกใช้แอปพลิเคชัน Hello World ของเราโดยใช้กรอบงาน Struts 2

ขั้นตอนการดำเนินการแอปพลิเคชัน

คลิกขวาที่ชื่อโครงการแล้วคลิก Export > WAR File เพื่อสร้างไฟล์ War

จากนั้นปรับใช้ WAR นี้ในไดเร็กทอรี webapps ของ Tomcat

สุดท้ายเริ่มเซิร์ฟเวอร์ Tomcat และพยายามเข้าถึง URL http://localhost:8080/HelloWorldStruts2/index.jsp. ซึ่งจะแสดงหน้าจอต่อไปนี้ -

ป้อนค่า "Struts2" และส่งเพจ คุณควรเห็นหน้าถัดไป

โปรดทราบว่าคุณสามารถกำหนด index เป็นการกระทำในไฟล์ struts.xml และในกรณีนั้นคุณสามารถเรียกหน้าดัชนีเป็น http://localhost:8080/HelloWorldStruts2/index.action. ตรวจสอบด้านล่างว่าคุณสามารถกำหนดดัชนีเป็นการกระทำได้อย่างไร -

<?xml version = "1.0" Encoding = "UTF-8"?>
<!DOCTYPE struts PUBLIC
   "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
   "http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
   <constant name = "struts.devMode" value = "true" />
   <package name = "helloworld" extends = "struts-default">

      <action name = "index">
         <result >/index.jsp</result>
      </action>

      <action name = "hello" 
         class = "com.tutorialspoint.struts2.HelloWorldAction" 
         method = "execute">
         <result name = "success">/HelloWorld.jsp</result>
      </action>

   </package>
</struts>