P/S: Mình đã tạo mới một Maven Archetype project để việc tạo mới Spring MVC project dễ dàng hơn. Các bạn có thể xem thêm ở đây.
Trong bài viết này, mình hướng dẫn cho các bạn những bước cơ bản để tạo một dự án web có sử dụng Spring trong Spring Tool Suite bằng cách sử dụng Spring Legacy Project. Đây là những bước cơ bản mình thường làm, các bạn có thể tham khảo để áp dụng cho thực tế của các bạn.
Tạo project mới sử dụng Spring Legacy Project
Mình đang sử dụng Spring Tool Suite phiên bản 3.9.16.RELEASE. Hiện tại thì các bạn có thể download latest version của Spring Tool Suite 3 ở địa chỉ này https://github.com/spring-projects/toolsuite-distribution/wiki/Spring-Tool-Suite-3.
Để tạo một web project mới, các bạn vào File, chọn New và chọn Spring Legacy Project. Một cửa sổ mới sẽ hiển thị như sau:
Trong ô Project name, các bạn điền tên của project của mình, còn trong ô Templates, hãy chọn Spring MVC Project như hình sau:
Bây giờ các bạn nhấn nút Next.
Spring Tool Suite sẽ download template cho Spring MVC Project, do đó các bạn hãy chọn Yes nếu gặp cửa sổ sau nhé:
Sau khi download xong, Spring Tool Suite sẽ hiện ra cửa sổ mới.
Trong cửa sổ mới này, các bạn nhập tên package ban đầu cho project của mình nhé! Ở đây mình nhập com.huongdanjava.springmvc.
Sau đó, các bạn nhấn Finish để Spring Tool Suite tạo project mới cho mình.
Kết quả:
Chỉnh sửa project cho phù hợp với nhu cầu của bạn
Hãy mở rộng tất cả các node của project để xem chúng ta có những gì nhé các bạn.
Ở đây chúng ta có một Controller trong package com.huongdanjava.springmvc tên là HomeController. Controller này mặc định sẽ xử lý trang chào mừng khi chúng ta chạy ứng dụng web. Cái này chúng ta chưa cần chỉnh sửa.
Tiếp theo, chúng ta có một tập tin log4j.xml trong main resource và tương tự một tập tin log4j.xml trong test resource. Cái này chúng ta cũng chưa cần chỉnh sửa.
Bên trong thư mục WEB-INF của thư mục src/main/webapp/ chúng ta có thư mục spring chứa tất cả các cấu hình của Spring. Chúng ta cũng chưa cần phải thay đổi cái này.
Cũng trong thư mục src/main/webapp chúng ta có thư mục views. Bên trong thư mục views chúng ta có tập tin home.jsp để hiển thị trang chào mừng.
Và cuối cùng cái mình muốn nói ở đây là tập tin Maven pom.xml. Chúng ta sẽ cần chỉnh sửa tập tin pom.xml để nâng version của các thư viện lên mới nhất.
Phiên bản hiện tại của các dependency thể hiện rõ qua:
|
1 2 3 4 5 6 |
<properties> <java-version>1.6</java-version> <org.springframework-version>3.1.1.RELEASE</org.springframework-version> <org.aspectj-version>1.6.10</org.aspectj-version> <org.slf4j-version>1.6.6</org.slf4j-version> </properties> |
Việc khai báo property “java-version” ở đây theo mình nghĩ là không cần thiết. Chúng ta nên khai báo các property “maven.compiler.source” và “maven.compiler.target” để Maven biết Java version mà chúng ta cần sử dụng cho project của mình với Maven Compiler Plugin. Trong phần khai báo plugin trong tập tin pom.xml, plugin Maven Compliler Plugin cũng được khai báo, các bạn hãy nâng nó lên latest version và remove config source và target đi nhé!
|
1 2 3 4 5 6 7 8 9 10 |
<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.8.1</version> <configuration> <compilerArgument>-Xlint:all</compilerArgument> <showWarnings>true</showWarnings> <showDeprecation>true</showDeprecation> </configuration> </plugin> |
Spring framework thì hiện giờ đã lên đến phiên bản 5.3.6 rồi.
AspectJ và slf4j nếu các bạn có dùng trong project của mình thì cũng nên nâng lên latest version.
Phần properties, mình chỉnh sửa như sau:
|
1 2 3 4 5 6 7 |
<properties> <maven.compiler.source>1.8</maven.compiler.source> <maven.compiler.target>1.8</maven.compiler.target> <org.springframework-version>5.3.6</org.springframework-version> <org.aspectj-version>1.9.6</org.aspectj-version> <org.slf4j-version>1.7.30</org.slf4j-version> </properties> |
Kết quả:
thechicken
Chào anh, khi e tạo project: Spring Legacy Project –> Spring MVC Project thì bị lỗi: HTTP 404 The requested resource is not available, cái tool nó tự config các file xml, e thấy cũng đúng, vậy không bít sữa lỗi ở đâu, e cũng google nhiều mà không tìm được giải thích sửa lỗi, em dùng STS 3.8.1
Khanh Nguyễn
Anh đã trả lời cho em bên Fanpage Facebook rồi nhé!
Có gì cứ liên hệ anh 😀
Cảm ơn em đã ủng hộ Hướng Dẫn Java.
Khanh Nguyễn
Đối với STS 3.8.1 thì để tạo một project Spring MVC thì bạn chọn File –> Spring Legacy Project nhé!
Cái bạn đang chọn là Spring Starter Project sử dụng Spring Boot. Mình cũng thử tạo một project sử dụng cái này, nó hoạt động bình thường nhé bạn!
Bạn thử lại lần nữa xem, có thể do lúc đó mạng có vấn đề nên không kết nối tới URL này được.
Miyake
Thanks bạn nhiều, mình tạo project được rồi 😀
Miyake
Help me!
Khi tạo project spring thì gặp lỗi “Ioexception: server returned HTTP response code 403 for URL:http://start.spring.io“.
Mình dùng STS 3.8.1.