Java with ant là gì

Phần mềm bắt buộc

Phần mềm sau đây được yêu cầu để chạy các ví dụ.

  • Gói hướng dẫn

  • Nền tảng Java, Phiên bản Chuẩn

  • Máy chủ ứng dụng hệ thống Sun Java 9.1

  • NetBeans IDE

  • Apache Ant

Gói hướng dẫn

Nguồn ví dụ hướng dẫn được chứa trong gói hướng dẫn.

Để có được nhóm hướng dẫn

  1. Mở URL sau đây trong một trình duyệt web:

    Http://javaeetutorial.java.net/

  2. Nhấp vào liên kết Tải xuống ở thanh bên trái.
  3. Trong bảng trên trang Tải xuống, xác định vị trí phiên bản ổn định mới nhất của tệp tin zip của Java EE 5 Tutorial.
  4. Nhấp chuột phải vào tên tệp zip và lưu nó vào hệ thống của bạn.
  5. Giải nén tệp zip vào một vị trí bạn chọn.

    Gói hướng dẫn giải nén vào thư mục javaeetutorial5 .

Bước tiếp theo

Sau khi bạn đã cài đặt gói hướng dẫn, mã nguồn ví dụ nằm trong Tut-install / javaeetutorial5 / examples / thư mục, nơi tut-install là thư mục nơi bạn cài đặt hướng dẫn. Thư mục ví dụ chứa các thư mục con cho mỗi công nghệ được thảo luận trong hướng dẫn.

Nền tảng Java, Phiên bản Chuẩn

Để xây dựng, triển khai và chạy các ví dụ, bạn cần một bản sao của Nền tảng Java, Standard Edition 5.0 hoặc Java Platform, Standard Edition 6.0 (J2SE 5.0 hoặc JDK 6). Bạn có thể tải về phần mềm J2SE 5.0 từ http://www.oracle.com/technetwork/java/javase/downloads/index-jdk5-jsp-142662.html . Bạn có thể tải về phần mềm JDK 6 từ http://www.oracle.com/technetwork/java/javase/downloads/index.html .

Tải xuống bản cập nhật JDK hiện tại mà không bao gồm bất kỳ phần mềm nào khác (chẳng hạn như NetBeans hoặc Java EE).

Máy chủ ứng dụng hệ thống Sun Java 9.1

Sun Java System Application Server 9.1 được nhắm mục tiêu như là môi trường xây dựng và thời gian chạy cho các ví dụ hướng dẫn. Để xây dựng, triển khai, và chạy các ví dụ, bạn cần một bản sao của Máy chủ ứng dụng và, tùy chọn, NetBeans IDE. Bạn có thể tải về Máy chủ ứng dụng từ http://java.sun.com/javaee/downloads/previous_u6/index.jsp .

Cuộn xuống phần có tiêu đề Tải về Hợp phần Độc lập và nhấp vào liên kết Tải xuống bên cạnhCập nhật Máy chủ ứng dụng Hệ thống Sun Java 9.1 2.


Lưu ý - Bạn cũng có thể chạy các ví dụ hướng dẫn sử dụng GlassFish v2.


Tham khảo trang Java EE Tutorial Compatibility Wiki để biết thông tin về các phiên bản của Máy chủ ứng dụng và Sun GlassFish Enterprise Server với các ví dụ hướng dẫn đã được kiểm tra.

Mẹo cài đặt máy chủ ứng dụng

Trong quá trình cài đặt Máy chủ ứng dụng:

  • Chấp nhận tên người dùng quản trị mặc định và chỉ định mật khẩu. Tên người dùng mặc định là admin . Nhớ mật khẩu bạn chỉ định. Bạn sẽ cần tên người dùng và mật khẩu này.

  • Chọn nút radio Không Tên Nhanh Tên Người Dùng và Mật Khẩu Quản Trị.

  • Lưu ý cổng HTTP tại đó máy chủ được cài đặt. Hướng dẫn này giả định rằng bạn đang chấp nhận cổng mặc định của 8080. Nếu 8080 được sử dụng trong quá trình cài đặt và trình cài đặt chọn một cổng khác hoặc nếu bạn tự quyết định thay đổi nó, bạn sẽ cần phải cập nhật tệp tin thuộc tính chung xây dựng (mô tả trong phần tiếp theo Phần) và các tập tin cấu hình cho một số ví dụ hướng dẫn để phản ánh đúng cổng.

Hướng dẫn này đề cập đến thư mục nơi bạn cài đặt máy chủ ứng dụng như là cài đặt . Ví dụ, thư mục cài đặt mặc định trên Microsoft Windows là C: \ Sun \ AppServer , do đó , cài đặt là C: \ Sun \ AppServer .

Sau khi cài đặt máy chủ ứng dụng, thêm các thư mục sau vào PATH của bạn để tránh phải chỉ định đường dẫn đầy đủ khi sử dụng lệnh:

Như-cài đặt / bin
As-install / lib / ant / bin

NetBeans IDE

Môi trường phát triển tích hợp NetBeans (IDE) là một IDE nguồn mở miễn phí để phát triển các ứng dụng Java, bao gồm các ứng dụng doanh nghiệp. NetBeans IDE hỗ trợ nền tảng Java EE 5. Bạn có thể xây dựng, đóng gói, triển khai, và chạy các ví dụ hướng dẫn từ bên trong NetBeans IDE.

Bạn có thể tải NetBeans IDE từ http://www.netbeans.org/ .

Tham khảo trang Java EE Tutorial Compatibility Wiki để biết thông tin về các phiên bản của NetBeans IDE với các ví dụ hướng dẫn đã được kiểm tra.

Apache Ant

Ant là công cụ xây dựng dựa trên công nghệ Java được phát triển bởi Apache Software Foundation ( http://ant.apache.org/ ) và được sử dụng để xây dựng, đóng gói và triển khai các ví dụ hướng dẫn. Ant được bao gồm trong Máy chủ ứng dụng. Để sử dụng lệnh ant , thêmAs-install / lib / ant / bin vào biến môi trường PATH của bạn.

Bắt đầu và Ngừng Máy chủ ứng dụng

Để khởi động Máy chủ Ứng dụng, mở cửa sổ terminal hoặc dấu nhắc lệnh và thực hiện như sau:

Tên miền bắt đầu-asadmin domain1

Một miền là một tập hợp của một hoặc nhiều Server instance ứng dụng bởi một máy chủ quản quản lý. Liên kết với miền là như sau:

  • Số cổng của máy chủ ứng dụng. Mặc định là 8080.

  • Số cổng của máy chủ quản trị. Mặc định là 4848.

  • Tên người dùng quản trị và mật khẩu.

Bạn chỉ định các giá trị này khi bạn cài đặt máy chủ ứng dụng. Các ví dụ trong hướng dẫn này giả sử rằng bạn đã chọn các cổng mặc định.

Không có đối số, lệnh start-domain khởi tạo miền mặc định, đó là domain1 . Các --verbose cờ gây ra tất cả các đăng nhập và gỡ lỗi đầu ra xuất hiện trên cửa sổ terminal hoặc dấu nhắc lệnh (nó cũng sẽ đi vào đăng nhập máy chủ, mà nằm ởDomain-dir /logs/server.log ).

Hoặc trên Windows, bạn có thể chọn:

Chương trình → Sun Microsystems → Máy chủ ứng dụng PE 9 → Bắt đầu Máy chủ Mặc định

Sau khi máy chủ đã hoàn thành trình tự khởi động, bạn sẽ thấy kết quả sau:

Miền domain1 đã bắt đầu.

Để dừng máy chủ ứng dụng, mở cửa sổ terminal hoặc dấu nhắc lệnh và thực hiện:

Asadmin stop-domain domain1

Hoặc, trên Windows, chọn:

Các chương trình → Sun Microsystems → Máy chủ ứng dụng PE 9 → Stop Default Server

Khi máy chủ đã dừng, bạn sẽ thấy kết quả sau:

Domain domain1 đã ngừng.

Bắt đầu Bảng Điều khiển dành cho Quản trị viên

Để quản lý Máy chủ ứng dụng và quản lý người dùng, tài nguyên và các ứng dụng Java EE, hãy sử dụng công cụ Bảng Điều khiển dành cho Quản trị viên. Máy chủ ứng dụng phải chạy trước khi bạn gọi tới Bảng Điều khiển dành cho Quản trị viên. Để bắt đầu Bảng Điều khiển dành cho Quản trị viên, hãy mở trình duyệt tại http: // localhost: 4848 / asadmin / .

Trên Windows, từ trình đơn Start, chọn:

Các chương trình → Sun Microsystems → Máy chủ ứng dụng PE 9 → Máy chủ ứng dụng

Khởi động và Ngừng Cơ sở dữ liệu Java DB

Máy chủ ứng dụng bao gồm cơ sở dữ liệu Java DB.

Để khởi động máy chủ cơ sở dữ liệu Java DB, mở cửa sổ terminal hoặc dấu nhắc lệnh và thực hiện:

Cơ sở dữ liệu asadmin khởi động

Trên Windows, từ trình đơn Start, chọn:

Các chương trình → Sun Microsystems → Máy chủ ứng dụng PE 9 → Bắt đầu Java DB

Để dừng máy chủ Java DB, mở cửa sổ terminal hoặc dấu nhắc lệnh và thực hiện:

Cơ sở dữ liệu asadmin stop

Trên Windows, từ trình đơn Start, chọn:

Các chương trình → Sun Microsystems → Máy chủ ứng dụng PE 9 → Stop Java DB

Để biết thông tin về cơ sở dữ liệu Java DB có trong Máy chủ ứng dụng, xem http://www.oracle.com/technetwork/java/javadb/overview/index.html.

Xây dựng ví dụ

Các ví dụ hướng dẫn được phân phối với một tệp cấu hình cho NetBeans IDE hoặc Ant. Hướng dẫn xây dựng các ví dụ được cung cấp trong mỗi chương. Hoặc NetBeans IDE hoặc Ant có thể được sử dụng để xây dựng, đóng gói, triển khai, và chạy các ví dụ.

Xây dựng các ví dụ sử dụng NetBeans IDE

Để chạy các ví dụ hướng dẫn trong NetBeans IDE, bạn phải đăng ký cài đặt Máy chủ ứng dụng của bạn như một NetBeans Server Instance. Làm theo các hướng dẫn dưới đây để đăng ký Máy chủ Ứng dụng trong NetBeans IDE.

  1. Chọn Tools → Server Manager để mở hộp thoại Server Manager.

  2. Nhấp vào Thêm máy chủ.

  3. Trong Máy chủ, chọn Máy chủ ứng dụng Hệ điều hành Sun Java và nhấp vào Tiếp theo.

  4. Trong Vị trí nền tảng, nhập vị trí cài đặt Máy chủ ứng dụng của bạn.

  5. Chọn Đăng ký miền Mặc định Địa phương và nhấp vào Tiếp theo.

  6. Trong Tên đăng nhập Quản trị và Mật khẩu Quản trị, nhập tên quản trị viên và mật khẩu được tạo khi bạn cài đặt Máy chủ Ứng dụng.

  7. Nhấp vào Hoàn tất.

Xây dựng các ví dụ trên dòng lệnh sử dụng Ant

Xây dựng các thuộc tính chung cho tất cả các ví dụ được xác định trong tệp build.properties trongTut-install / javaeetutorial5 / example / bp-project / thư mục. Bạn phải tạo tệp này trước khi bạn có thể chạy các ví dụ. Sao chép tệp build.properties.sample để build.properties và chỉnh sửa nó để phản ánh môi trường của bạn. Các ví dụ hướng dẫn sử dụng hệ thống xây dựng Java BluePrints và cấu trúc bố cục ứng dụng.

Để chạy các kịch bản Ant, bạn phải thiết lập các thuộc tính chung trong tệp tin Tut-install /javaeetutorial5/examples/bp-project/build.properties như sau:

  • Đặt thuộc tính javaee.home vào vị trí cài đặt máy chủ ứng dụng của bạn. Quá trình xây dựng sử dụng thuộc tính javaee.home để bao gồm các thư viện trongAs-install / lib / trong classpath. Tất cả các ví dụ chạy trên Máy chủ ứng dụng bao gồm tệp lưu trữ thư viện Java EE,As -install /lib/javaee.jar . Trong classpath xây dựng. Một số ví dụ sử dụng thư viện bổ sung trongNhư-cài đặt / lib / ; Các thư viện yêu cầu được liệt kê trong các chương trình công nghệ cá nhân.


    Lưu ý - Trên Windows, bạn phải thoát bất kỳ dấu gạch chéo ngược nào trong thuộc tính javaee.home bằng dấu gạch chéo ngược khác hoặc sử dụng dấu gạch chéo phía trước làm dấu phân cách đường dẫn. Vì vậy, nếu cài đặt máy chủ ứng dụng của bạn là C: \ Sun \ AppServer , bạn phải đặt javaee.home thành javaee.home = C: \\ Sun \\ AppServer hoặc javaee.home = C: / Sun / AppServer .


  • Đặt thuộc tính javaee.tutorial.home vào vị trí hướng dẫn của bạn. Thuộc tính này được sử dụng để triển khai và triển khai Ant.

    Ví dụ, trên UNIX:

    Javaee.tutorial.home = / home / tên người dùng / javaeetutorial5

    Trên Windows:

    Javaee.tutorial.home = C: / javaeetutorial5

    Không cài đặt hướng dẫn vào một vị trí có khoảng trống trong đường dẫn.

  • Nếu bạn không chấp nhận các giá trị mặc định cho người dùng quản trị và mật khẩu, hãy thiết lập thuộc tính admin.user với giá trị bạn chỉ định khi cài đặt Máy chủ ứng dụng và đặt mật khẩu của người dùng quản trị trong tệp admin-password.txt trongTut-install / javaeetutorial5 / example / common / với giá trị bạn chỉ định khi cài đặt máy chủ ứng dụng.

  • Nếu bạn không sử dụng cổng 8080, hãy đặt thuộc tính domain.resources.port thành giá trị được chỉ định khi bạn cài đặt Máy chủ ứng dụng.

Hướng dẫn Ví dụ Cấu trúc thư mục

Để tạo thuận lợi cho sự phát triển lặp đi lặp lại và giữ cho nguồn ứng dụng tách biệt với các tệp biên dịch, ví dụ hướng dẫn sử dụng cấu trúc thư mục ứng dụng Java BluePrints.

Mỗi mô đun ứng dụng có cấu trúc sau:

  • Build.xml : tệp Ant build

  • Src / java : các tệp nguồn Java cho mô đun

  • Src / conf : các tệp cấu hình cho mô-đun, ngoại trừ các ứng dụng web

  • Web : các trang JSP và HTML, các trang định kiểu, các tệp thẻ và hình ảnh

  • Web / WEB-INF : các tệp cấu hình cho các ứng dụng web

  • Nbproject : Các tệp dự án của NetBeans

Các ví dụ có nhiều mô đun ứng dụng được đóng gói trong một kho lưu trữ ứng dụng doanh nghiệp (hoặc EAR) có thư mục con submodule sử dụng các quy ước đặt tên sau:

  • Example -name -app-client : Ứng dụng khách hàng

  • Example -name -ejb : Các tệp JAR của các máy chủ doanh nghiệp

  • Example -name -war : các ứng dụng web

Các tệp Ant build ( build.xml ) được phân phối với các ví dụ chứa các mục tiêu để tạo ra một thư mục con xây dựng và để sao chép và biên dịch các tệp vào thư mục đó; Một thư mục con dist , chứa tệp module được đóng gói; Và một thư mục client-jar , chứa ứng dụng khách JAR thu được.

Gỡ lỗi ứng dụng Java EE

Phần này mô tả làm thế nào để xác định những gì gây ra một lỗi trong triển khai ứng dụng hoặc thực hiện của bạn.

Sử dụng nhật ký máy chủ

Một cách để gỡ lỗi ứng dụng là nhìn vào đăng nhập máy chủ Domain-dir /logs/server.log . Nhật ký có chứa đầu ra từ Máy chủ ứng dụng và các ứng dụng của bạn. Bạn có thể đăng nhập các thông báo từ bất kỳ lớp Java nào trong ứng dụng của mình bằng System.out.println và các API ghi nhật ký Java (tài liệu tại http://download.oracle.com/javase/6/docs/technotes/guides/logging/index.html ) Và từ các thành phần web với phương thức ServletContext.log .

Nếu bạn khởi động Máy chủ Ứng dụng với cờ --verbose , tất cả các kết xuất và gỡ lỗi đầu ra sẽ xuất hiện trên cửa sổ terminal hoặc dấu nhắc lệnh và đăng nhập máy chủ. Nếu bạn khởi động Máy chủ Ứng dụng ở chế độ nền, gỡ lỗi thông tin chỉ có trong bản ghi. Bạn có thể xem nhật ký máy chủ bằng trình chỉnh sửa văn bản hoặc với trình xem bản ghi của Bảng điều khiển dành cho Quản trị viên.

Để sử dụng trình xem bản ghi:

  1. Chọn nút Máy chủ ứng dụng.

  2. Chọn tab Đăng nhập.

  3. Nhấp vào nút Mở trình đăng nhập. Trình xem nhật ký sẽ mở và hiển thị 40 mục nhập mới nhất.

Nếu bạn muốn hiển thị các mục khác:

  1. Nhấp vào nút Modify Search.

  2. Chỉ định bất kỳ ràng buộc nào đối với các mục mà bạn muốn xem.

  3. Nhấp vào nút Tìm kiếm ở cuối trình xem nhật ký.

Sử dụng trình gỡ lỗi

Máy chủ ứng dụng hỗ trợ Java Debugger Platform Debugger (JPDA). Với JPDA, bạn có thể cấu hình Máy chủ Ứng dụng để truyền thông thông tin gỡ lỗi bằng cách sử dụng một ổ cắm.

Để gỡ lỗi một ứng dụng bằng cách sử dụng trình sửa lỗi:

  1. Bật gỡ lỗi trong Máy chủ ứng dụng bằng Bảng Điều khiển dành cho Quản trị viên:

    1. Chọn nút Máy chủ ứng dụng.

    2. Chọn tab Cài đặt JVM. Tùy chọn gỡ lỗi mặc định được đặt thành:

      -Xdebug -Xrunjdwp: transport = dt_socket, server = y, tạm dừng = n, địa chỉ = 9009

      Như bạn thấy, cổng trình cắm gỡ lỗi mặc định là 9009. Bạn có thể thay đổi nó thành một cổng không được sử dụng bởi Máy chủ ứng dụng hoặc dịch vụ khác.

    3. Chọn hộp Bật của trường Gỡ lỗi.

    4. Nhấp vào nút Lưu.

  2. Dừng máy chủ ứng dụng và khởi động lại nó.