Bắt đầu với Maven Alfresco SDK phần 2

Chúng tôi làm việc với dự án của bạn trong IDE

• Tệp, Nhập, Maven, Dự án Maven hiện có. Bấm tiếp.
  
• Chỉ định thư mục chứa thư mục someco-mvn-tutorial-repo. Eclipse sẽ kiểm tra thư mục này và hiển thị dự án của bạn trong danh sách các dự án. Đảm bảo hộp kiểm bên cạnh tên dự án được chọn và nhấp vào Tiếp theo.
  
• Eclipse sẽ hiển thị các cài đặt Bảng điều khiển Plugin Maven. Bạn có thể yên tâm bỏ qua nó ngay bây giờ. Bấm vào Kết thúc.
  

1. Nhấp chuột phải vào lỗi và chọn "Khắc phục nhanh".
2. Chọn "Đánh dấu vĩnh viễn phiên bản đặt mục tiêu trong pom.xml là bị bỏ qua trong bản dựng Eclipse". Sẵn sàng.
3. Chọn vị trí đặt POM của bạn (của tôi là com.someco : someco-mvn-tutorial-repo : 1.0-SNAPSHOT) và nhấp vào OK.

1. Nhấp chuột phải vào dự án và chọn Maven, Cập nhật dự án.
2. Hãy chắc chắn rằng dự án được chọn và nhấp vào OK.

Hiểu cấu trúc dự án

• pom.xml Trong thư mục gốc của dự án, bạn sẽ thấy pom.xml. Nó cho Maven biết mọi thứ cần biết về dự án của bạn. Bạn có nhớ một số cài đặt bạn đã quên khi tạo dự án từ mẫu không? Bạn có thể thực hiện thay đổi trong cài đặt tại đây. Ví dụ: phiên bản 1.1.1 của nguyên mẫu cho phép bạn làm việc với Alfresco Community Edition phiên bản 4.2.e. Nếu bạn muốn làm việc với một phiên bản khác - chỉ cần thay đổi một vài thuộc tính và yêu cầu Maven cập nhật chúng và Maven sẽ lo phần còn lại.
• src/main/java Đây là nơi bạn nên tạo các gói của riêng mình để sắp xếp mã Java của mình. Những thứ như lớp thực thi hành động tùy chỉnh, hành vi tùy chỉnh, bộ điều khiển Java cho tập lệnh web đều có ở đây. Nếu bạn không biết tất cả những điều này là gì, đừng lo lắng, có sẵn các hướng dẫn ở đây . Những tệp này cuối cùng sẽ được đặt trong JAR. Khi AMP được cài đặt trong Alfresco WAR, JAR sẽ ở bên trong WEB-INF/lib .
• src/test Mọi thứ bên trong src/test đều liên quan đến việc thực hiện kiểm thử. Bản thân các bài kiểm tra đơn vị được đặt trong src/test/java . Mọi tài nguyên mà các lớp này cần sẽ có trong src/test/resources. Bên trong src/test/properties/local bạn sẽ thấy tệp alfresco-global.properties . Nếu bạn đã biết gì về Alfresco thì bạn biết rằng nó được sử dụng để định cấu hình máy chủ Alfresco. Trong trường hợp này, nó chỉ được sử dụng để chạy máy chủ nhúng nhằm mục đích thử nghiệm.
• src/main/amp Mọi thứ khác đều nằm ở đâu đó trong phần này của dự án. Cấu trúc AMP được ghi chép rõ ràng đến mức tôi không muốn sao chép nó ở đây. Tôi sẽ chỉ nêu ra những điểm chính:
  
  • Tệp module.properties cho Alfresco biết những điều cần biết về AMP chẳng hạn như ID, phiên bản, phiên bản tối thiểu và tối đa của Alfresco cần có để chạy AMP và bất kỳ AMP nào khác có cùng phần phụ thuộc.
  • Thư mục config/alfresco/module/someco-mvn-tutorial-repo là trái tim của AMP. Nơi bạn sẽ đặt các cấu hình tệp Spring XML, mô hình nội dung của các tệp XML và cấu hình giao diện người dùng. Như bạn sẽ thấy sau, tôi thích tách các thư mục con cho từng thứ này.
  • Nếu mô-đun của bạn bao gồm các tập lệnh web hoặc quy trình làm việc thì chúng sẽ không có trong thư mục mô-đun. Thay vào đó, chúng nằm trong config/alfresco/extension/templates/webscripts và config/alfresco/extension/workflows .
  • Mô-đun của bạn có thể bao gồm các tài nguyên máy khách phải được triển khai vào thư mục gốc của ứng dụng web. Chúng nằm ở src/main/amp/web trong thư mục css, jsp, script và hình ảnh.

Tạo dự án được điều chỉnh cho quyền truy cập Chia sẻ

Phụ thuộc chung của dự án

mục tiêu chiến tranh

Hãy thử điều này: Tạo dự án Chia sẻ bằng cách sử dụng nguyên mẫu

1. Tệp, Dự án Maven mới.
2. Chọn thư mục chứa thư mục dự án "repo", nhấp vào Tiếp theo.
   
3. Nhấp vào Cấu hình và chúng ta có thể thêm thư mục Alfresco vào danh sách.
   
4. Nhấp vào Thêm danh mục từ xa
5. Chọn "https://artifacts.alfresco.com/nexus/content/groups/public/archetype-catalog.xml" làm Tệp danh mục. Chọn mô tả "Các nguyên mẫu ngoài trời". Sau đó, nhấp vào OK và OK lần nữa gần bảng Tùy chọn.
   
6. Bây giờ hãy chọn "Alfresco Archetypes" trong thư mục và bạn sẽ thấy một loạt các nguyên mẫu trong danh sách.
7. Chọn "org.alfresco.maven.archetype" và hai nguyên mẫu giống nhau sẽ xuất hiện trong bộ lọc như ở phần đầu của hướng dẫn.
8. Chọn alfresco-amp-archetype và nhấp vào Tiếp theo.
   
9. Chọn "com.someco" cho groupId, "someco-mvn-tutorial-share" làm ArtifactId và thay đổi alfresco_target_amp_client_war thành "share". Bấm vào Kết thúc.
   

Hiểu cấu trúc thư mục Share Access

Ra mắt thử nghiệm nội bộ trên Share

cd someco-mvn-tutorial-repo
mvn Integration-test -Pamp-to-war

cd someco-mvn-tutorial-share
mvn Integration-test -Pamp-to-war -Dmaven.tomcat.port=8081

Quản lý phụ thuộc

Hệ thống phân cấp phụ thuộc trong Eclipse Một tùy chọn khác. Bạn có thể xem hệ thống phân cấp phụ thuộc bằng cách chạy:

phụ thuộc mvn: danh sách

Vì vậy, để thêm các tập lệnh web dựa trên Java vào dự án Chia sẻ của bạn, chúng ta cần thêm các tập lệnh web mùa xuân làm phần phụ thuộc. Bạn có thể làm điều này bằng cách chỉnh sửa pom.xml như thế này:

<sự phụ thuộc>
    <groupId>org.springframework.extensions.surf</groupId>
    <artifactId>webscript mùa xuân</artifactId>
    <version>1.2.0-M14</version>
    <scope>được cung cấp</scope>
</phụ thuộc>

Giờ đây, các tập lệnh web dựa trên Java sẽ có thể tìm thấy lớp cha của chúng - DeclarativeWebScript.
Bạn có thể thắc mắc làm thế nào bạn biết được rằng lớp DeclarativeWebScript đã được đưa vào tạo phẩm spring-webscripts. Chà, ví dụ, bạn đã tìm thấy nó bằng cách truy cập http://artifacts.alfresco.com . Bạn có thể tìm kiếm theo lớp và bạn sẽ được hiển thị tất cả các hiện vật có chứa nó.

Các chủ đề khác để nghiên cứu độc lập

Bây giờ bạn đã biết cách sử dụng Alfresco Maven SDK để tạo dự án cũng như làm kho lưu trữ Alfresco và định cấu hình Alfresco Share. Nếu bạn là người mới bắt đầu phát triển Alfresco, tôi hy vọng bạn sẽ đồng ý rằng việc kết hợp một dự án để bắt đầu thực sự dễ dàng. Nếu bạn đã bắt đầu sử dụng Alfresco nhưng vẫn đang sử dụng SDK cũ, tôi hy vọng điều này sẽ thúc đẩy bạn chuyển sang SDK mới để tạo AMP của mình.
Có nhiều chủ đề chưa được đề cập trong hướng dẫn này. Tôi sẽ để chúng cho bạn khám phá theo ý riêng của bạn. Dưới đây là một số trong số họ:

• SDK Alfresco Maven hỗ trợ tải lại lớp động khi được sử dụng cùng với công cụ có tên JRebel .
• Hướng dẫn này bao gồm nguyên mẫu AMP. Nhưng Alfresco Maven SDK bao gồm một nguyên mẫu khác gọi là Tất cả trong một. Nguyên mẫu này cung cấp cho bạn bản cài đặt Alfresco hoàn chỉnh bao gồm SOLR.
• Alfresco Maven SDK được hỗ trợ ở cả Phiên bản cộng đồng và Phiên bản doanh nghiệp. Nếu bạn cần hỗ trợ truy cập các tạo phẩm trong Phiên bản doanh nghiệp, hãy liên hệ với bộ phận Hỗ trợ của Alfresco.

Nơi để tìm thêm thông tin

• Tài liệu chính thức cho Alfresco Maven SDK có tại http://docs.alfresco.com .
• Bạn có thể tìm thấy tài liệu chi tiết hơn về Alfresco Maven SDK tại Artifacts.alfresco.com .
• Bài thuyết trình của Gab tại Hội nghị thượng đỉnh Alfresco dựa trên thử nghiệm, phát triển nhanh chóng và cung cấp liên tục các giải pháp Alfresco
• Bộ khởi động Apache Maven tức thì Cuốn sách của Maurizio Turatti và Maurizio Pillitu có thể là một nguồn tài nguyên tuyệt vời nếu bạn muốn tìm hiểu thêm về Apache Maven.
• Bắt đầu với Bài thuyết trình Phát triển Alfresco của Gethin James từ Hội nghị thượng đỉnh Alfresco
• Chuỗi nhà phát triển Alfresco trên ECM Architect chứa các hướng dẫn miễn phí về mô hình nội dung, hành động, hành vi, quy trình công việc và tập lệnh web tùy chỉnh.

<= Phần 1