Đây là tài liệu hướng dẫn cài đặt Liferay Framework, tài liệu được tạo ra nhằm bổ trợ chi tiết về nội dung cho tài liệu báo cáo tổng hợp. Trong tài liệu trình bày chi tiết về các bước cài đặt hệ thống, thành phần của Liferay Framework và kết quả sau khi cài đặt Liferay Framework. Ngoài ra trong tài liệu còn gồm có các phần nội dung hướng dẫn xây dựng và ví dụ minh họa một số thành phần của Liferay Framework.
BỘ GIÁO DỤC ĐÀO TẠO TRƯỜNG ĐẠI HỌC THĂNG LONG -o0o - KHÓA LUẬN TỐT NGHIỆP NGHIÊN CỨU LIFERAY PORTAL FRAMEWORK ỨNG DỤNG PHÁT TRIỂN WEBSITE VÀ QUẢN LÝ GIỜ NGHIÊN CỨU KHOA HỌC TRƯỜNG ĐẠI HỌC THĂNG LONG TÀI LIỆU 3: HƯỚNG DẪN CÀI ĐẶT LIFERAY FRAMEWORK SINH VIÊN THỰC HIỆN : A20414 - ĐỖ TIẾN KIÊN CHUYÊN NGÀNH HÀ NỘI - 2016 : KHOA HỌC MÁY TÍNH BỘ GIÁO DỤC ĐÀO TẠO TRƯỜNG ĐẠI HỌC THĂNG LONG -o0o - KHÓA LUẬN TỐT NGHIỆP NGHIÊN CỨU LIFERAY PORTAL FRAMEWORK ỨNG DỤNG PHÁT TRIỂN WEBSITE VÀ QUẢN LÝ GIỜ NGHIÊN CỨU KHOA HỌC TRƯỜNG ĐẠI HỌC THĂNG LONG TÀI LIỆU 3: HƯỚNG DẪN CÀI ĐẶT LIFERAY FRAMEWORK Giáo viên hướng dẫn : ThS.Mai Thúy Nga Sinh viên thực : A20414 - Đỗ Tiến Kiên Chuyên ngành : KHOA HỌC MÁY TÍNH HÀ NỘI – 2016 GIỚI THIỆU Đây tài liệu hướng dẫn cài đặt Liferay Framework, tài liệu tạo nhằm bổ trợ chi tiết nội dung cho tài liệu báo cáo tổng hợp Trong tài liệu trình bày chi tiết bước cài đặt hệ thống, thành phần Liferay Framework kết sau cài đặt Liferay Framework Ngoài tài liệu gồm có phần nội dung hướng dẫn xây dựng ví dụ minh họa số thành phần Liferay Framework Các phần nội dung tài liệu rõ trích dẫn cụ thể tài liệu báo cáo tổng hợp MỤC LỤC DANH MỤC HÌNH ẢNH MINH HỌA DANH MỤC TỪ VIẾT TẮT Ký hiệu viết tắt Tên đầy đủ NCKH Nghiên cứu khoa học GV Giảng viên HT Hệ thống BR Business requirement (Quy trình nghiệp vụ) UC Use case (Chức sử dụng) WCM Web content management (Quản lý nội dung trang web) SDK Software development kit (Bộ công cụ phát triển phần mềm) IDE Integrated Development Environment (Mơi trường phát triển tích hợp) LIFERAY PORTAL FRAMEWORK CHƯƠNG CÀI ĐẶT LIFERAY PORTAL FRAMEWORK 1.1 Các thành phần cần cài đặt − Database MySql 5: Download http://dev.mysql.com/downloads/installer/ − MySQL Workbench: Download http://dev.mysql.com/downloads/workbench/ − Liferay 6.2 Community Download https://www.liferay.com/downloads/liferay-portal/available-releases (Chọn phiên chạy server Tomcat) − Liferay 6.2 Community Plugins SDK Download https://www.liferay.com/downloads/liferay-portal/available-releases − Eclipse + Liferay IDE Download https://www.liferay.com/downloads/liferay-projects/liferay-ide − Java SE Development Kit Java SE Development Kit Download http://www.oracle.com/technetwork/java/javase/downloads/jdk8downloads-2133151.html 1.2 Hướng dẫn cài đặt Liferay portal 1.2.1 Cài đặt Java, thiết lập biến môi trường JAVA_HOME JRE_HOME − Cài đặt JDK vào hệ thống − Sau cài đặt thành công, ta cần thiết lập biến môi trường JAVA_HOME cập nhật biến môi trường path trỏ đến thư mục bin JDK − Click chuột phải lên Computer chọn Properties Khi hộp thoại System Properties ra, chọn tab Advanced Nhấn nút Environments Variables Khi hộp thoại Environment Variables ra, nhấn nút New mục System variables thiết lập giá trị sau: − Variables name: JAVA_HOME − Variable value: đường dẫn thư mục nơi cài JDK − Sau thiết lập biến JAVA_HOME, tìm biến PATH nhấn nút Edit Bổ sung thêm đoạn ;%JAVA_HOME%\bin; vào giá trị cũ biến PATH Đỗ Tiến Kiên Trang LIFERAY PORTAL FRAMEWORK 1.2.2 Cài đặt Liferay − Bước + Giải nén gói cài đặt vừa tải từ trang chủ Sau hoàn tất việc giải nén, ta thư mục liferay-portal-6.2-ce-ga6 có cấu trúc sau: _liferay-portal-6.2-ce-ga6 _data _license _tomcat-7.0.62 _readme.html Trong đó, thư mục data chứa cấu hình sở liệu mặc định (HSQL), license chứa thông tin quyền thư mục quan tomcat-7.0.62 chứa máy chủ Tomcat phiên chương trình Liferay cài đặt sẵn + Chi tiết thư mục Tomcat _tomcat-7.0.62 _bin _conf _lib _logs _temp _webapps _work _ Trong • bin: chứa chương trình cấu hình máy chủ Tomcat Trong thư mục này, ta để ý đến tệp tin catalina.bat, startup.bat shutdown.bat (trên HĐH Windows) catalina.sh, startup.sh shutdown.sh (trên HĐH Linux) • conf: chứa cấu hình máy chủ Tomcat portlet • lib: chứa thư viện cho máy chủ Tomcat Liferay • logs: chứa tệp tin log (theo ngày) • temp: chứa tệp tin tạm thời Đỗ Tiến Kiên Trang LIFERAY PORTAL FRAMEWORK • webapps: chứa chương trình Liferay (ROOT) portlet mặc định Sau này, tự phát triển portlet deploy vào thư mục • work: chứa dịch portlet − Bước 2: Cấu hình sở liệu + Hãy mở thư mục theo đường dẫn sau: /liferay-portal-6.2-ce-ga6/tomcat7.0.62/webapps/ROOT/WEB-INF/classes Trong thư mục classes tạo tệp tin có tên portal-ext.properties tệp tin chứa thơng tin cấu hình hệ thống mà muốn thay đổi + Mở tệp tin portal-ext.properties thêm vào dòng sau (tùy thuộc vào sở liệu sử dụng): Quy ước: • DATABASE_NAME: tên sở liệu (ví dụ: lportal_tutorial) • USER_NAME: tên người dụng (ví dụ: root với MySQL, sa với SQL Server, postgres với Postgresql, ) • PASSWORD: mật tương ứng người dùng sở liệu (VD 123456 cho đơn giản) • Cơ sở liệu cài máy địa localhost địa IP máy khác Các cổng mặc định (MySQL 3306, Postgresql 5432 SQL Server 1433 (hoặc khơng có)) MySQL: jdbc.default.driverClassName=com.mysql.jdbc.Driver jdbc.default.url=jdbc:mysql://localhost:3306/DATABASE_NAME? useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false jdbc.default.username=USER_NAME jdbc.default.password=PASSWORD Posgresql: jdbc.default.driverClassName=org.postgresql.Driver jdbc.default.url=jdbc:postgresql://localhost:5432/DATABASE_NAME jdbc.default.username=USER_NAME jdbc.default.password=PASSWORD Đỗ Tiến Kiên Trang LIFERAY PORTAL FRAMEWORK SQL Server: jdbc.default.driverClassName=net.sourceforge.jtds.jdbc.Driver jdbc.default.url=jdbc:jtds:sqlserver://localhost:1433/DATABASE_NAME jdbc.default.username=USER_NAME jdbc.default.password=PASSWORD − Bước 3: Tạo sở liệu Mở phần mềm quản trình sở liệu lên vào tạo sở liệu có tên lportal_tutorial (hoặc tên khác) Lưu ý: tên sở liệu phải giống với tên đặt file portal-ext.properties − Bước 4: Cấu hình chạy máy chủ Tomcat + Mở thư mục /liferay-portal-6.2-ce-ga6/tomcat-7.0.62/bin + Chạy tệp tin startup.bat + Khi máy chủ đưa thông báo: "INFO: Server startup in xxxx ms" nghĩa máy chủ khởi động xong Máy chủ sẻ tự động bật trình duyệt mặc định mở trình duyệt lên gõ địa chỉ: http://localhost:8080 vào điều hướng Giao diện Giao diện cấu hình Liferay Portal Đỗ Tiến Kiên Trang 10 LIFERAY PORTAL FRAMEWORK Giao diện 18 Tạo portlet − Điền thành phần: + Portlet class: tên class portlet, thành phần C (Controller) tron mơ hình MVC Phần đảm bảo tương tác giao diện (JSP) lớp service + Java packeage: tên gói Portlet class + Supper class: chọn mơ hình MVC nên chọn class com.liferay.util.bridges.mvc.MVCPortlet Đỗ Tiến Kiên Trang 25 LIFERAY PORTAL FRAMEWORK Giao diện 19 Tạo portlet − Click Next Điền thơng tin Portlet, tích chọn ô View, Edit, Help Giao diện 20 Tạo portlet − Click nút Finish Đỗ Tiến Kiên Trang 26 LIFERAY PORTAL FRAMEWORK Thêm project vào server − Click chuột phải vào máy chủ liferay, chọn Add and Remove − Bên trái danh sách ứng dụng (portlet, theme, ) chưa thêm vào máy chủ Bên phải danh sách project thêm vào máy chủ Ở đây, có project đầu tiên, chưa thêm vào máy chủ Bây click vào project vừa tạo sau nhấn vào nút "Add" sau nhấn vào nút Finish Bây giờ, khởi động máy chủ vào địa http://localhost:8080 Đăng nhập với người dùng quản trị (test@liferay.com) 3.2 Tạo Portlet sử dụng Teminar − Di chuyển vào thư mục portlet − Chạy lệnh tạo Portlet + Trên Mac OS X /create.sh [project-name] ["Portlet Display Name"] + Trên Windows /create.bat [project-name] ["Portlet Display Name"] Đỗ Tiến Kiên Trang 27 LIFERAY PORTAL FRAMEWORK 3.3 Cấu trúc Project Portlet Sơ đồ Cấu trúc thư mục Project Portlet Các thành phần gồm có − docroot/ - chứa tất nội dung ứng dụng + css/ - thư mục chứa tất file css ứng dụng, nên bỏ tất file css có vào + html/ - chứa file html, jsp Chúng ta thấy view.jsp file mặc định tạo Các portlet tổ chức thành thư mục + Js/ - chứa tất file javascript ứng dụng (thông thường ta có jquery thư viện khác) + META-INF/ + WEB-INF/ - chứa tất thứ liên quan đến phần back-end • • • • Đỗ Tiến Kiên lib/ - chứa thư viện portlet src/ - Thư mục ko tạo mặc định, chưa tệp tin java nguồn tld/ - chứa file DTD liferay-display.xml – Mô tả mục category xuất Trang 28 LIFERAY PORTAL FRAMEWORK • liferay-plugin-package.properties - chứa thơng tin portlet, khơng có ý nghĩa với người lập trình • liferay-portlet.xml • portlet.xml – tệp tin cấu hình chứa tiêu chuẩn JSR-286 • web.xml + icon.png + view.jsp − build.xml 3.4 Một số file Portlet − liferay-display.xml category: phân loại ứng dụng Mặc đinh ứng dụng vào loại Sample, muốn tự tạo loại cho riêng cần thay đổi thuộc tính name thẻ category portlet: thẻ có thuộc tính id sử dụng để phân biệt portlet với id phải giống với portlet-name file liferay-portlet.xml liferay.xml − liferay-portlet.xml: Đỗ Tiến Kiên Trang 29 LIFERAY PORTAL FRAMEWORK portlet-name: chứa tên chuẩn portlet, tên phải giống với giá trị thẻ file portlet.xml Thẻ chứa đường dẫn đến icon portlet Thẻ đường dẫn đền file css, có nheieuf thẻ Thẻ đường dẫn tới file javascript, có nhiều thẻ Thẻ giá trị năm thẻ thêm vào thuộc tính class thẻ div portlet, file css sau bạn nên đặt có dạng first-portlet abc có nghĩa hiệu ứng css có tác dụng portlet có có nội dung first-portlet Các thẻ ánh xạ role liferay portal với role portal (bạn lưu ý cổng thông tin khái niệm chúng, cổng thông tin Liferay theo chuẩn công thông tin) Đỗ Tiến Kiên Trang 30 LIFERAY PORTAL FRAMEWORK − portlet.xml Đỗ Tiến Kiên Trang 31 LIFERAY PORTAL FRAMEWORK Ta thấy có thơng tin portlet id portlet, tên hiển thị danh mục portlet tên đầy đủ Class, controller portlet Mỗi portlet nên có class controller riêng biệt 3.5 Ví dụ đơn giản hoạt động Portlet Ta tạo project có tên SendDataProject, sau tạo xong, tạo portlet mơi scó tên SendDataPortlet Tạo Portlet với thông tin sau: − Portlet class: SendDataPortlet − Java package: com.liferay.tutorial − Supperclass: com.liferay.util.bridges.mvc.MVCPortlet Xem lại bước tạo Portlet hướng dẫn phần 3.1 Tạo Portlet Liferay IDE Sau tạo Portlet ta thêm Portlet vào máy chủ chạy Nội dung hiển thị nội dung nằm file docroot\html\senddata\view.jsp Sửa nội dung file view.jsp thêm vào link mở giao diện để nhập vào chuỗi (tên) Thêm vào file view dòng sau: Đỗ Tiến Kiên Trang 32 LIFERAY PORTAL FRAMEWORK − Thẻ : Thẻ sinh URL gán vào biến editURL URL có dạng render dùng trường hợp mở liên kết ngược lại với dạng action thực thao tác (thêm, sửa, xóa ) − Thẻ : thêm tham số vào URL trên, ta hiểu sau: giả sử render URL có dạng là: http://abc.xyz sinh URL có dạng http://abc.xyz?mvcPath=/html/second/edit.jsp Thuộc tính name đặt bất kỳ, nhiên nên đặt có ý nghĩa Thuộc tính value đường dẫn đầy đủ tính từ docroot đến file jsp cần thiết − Thẻ : Chú ý thuộc tính href, ta thấy có lệnh editURL biến thẻ renderURL, ký hiệu thị JSP dùng để in giá trị biến edit Sau deploy lên server, portlet hiển thị sau: Giao diện 21 Ví dụ Portlet – Giao diện hiển thị file view Click vào Enter Name link render đến trang edit.jsp Chỉnh sửa file edit.jsp phép người dùng nhập vào chuỗi tên Đỗ Tiến Kiên Trang 33 LIFERAY PORTAL FRAMEWORK − thư viên aui nhóm Liferay viết lại − : tương tự file view.jsp dùng để định nghĩa biến toàn cục file − định nghĩa URL dạng action Tức dạng URL cho việc cập nhật, xóa, thêm thao tác khác − thẻ form dùng để cập nhật liệu Thuộc tính action URL, method="post" phương thức cập nhật liệu (tương tự form HTML thông thường) − textbox cho phép nhập vào chuỗi Thuộc tính name sử dụng để lấy giá trị trương ứng nhập vào − tạo nút để chuyển nội dung form xuống controller Sau chỉnh sửa file edit.jsp hiển thị sau: Nhập vào tên nhấn vào nút Submit Chúng ta cần phải bắt nội dung form gửi xuống controller, sau đó, từ controller ta gửi lại hình view Đỗ Tiến Kiên Trang 34 LIFERAY PORTAL FRAMEWORK Để bắt nội dung giử từ máy trạm xuống máy chủ Mở file java controller portlet SendDataPorlet.java nhập nội dung sau: − Phương thức processAction override từ phương thức tương ứng lớp cha Phương thức xử lý bất hành động gửi liệu từ máy cá nhân xuống máy chủ portlet Phương thức có hai tham số actionRequest chứa thông tin gửi từ máy khách xuống (bao gồm liệu form) actionResponse chứa liệu xử lý gửi lên trả lại − String name = ParamUtil.getString(actionRequest, "name"); có tác dụng lấy liệu từ máy khách gửi xuống, form có trường input có tên "name" nên ta đọc nội dung từ actionRequest hàm tiện ích ParamUtil − Các dòng xử lý liệu Trong trường hợp khơng gửi xuống trả thơng điệp "Hello World" trường hợp gửi xuống tên gửi lại lời chào − Dòng actionResponse.setRenderParameter("message", message); có tác dụng thêm vào luồng liệu trả lại giá trị có tên "message" có giá trị xử lý Đỗ Tiến Kiên Trang 35 LIFERAY PORTAL FRAMEWORK − Cuối ta gọi phương thức lớp cha Sửa lại file view.jsp sau để hiển thị liệu trả từ controller − String message = ParamUtil.getString(renderRequest, "message"); lấy liệu trả lại từ controller, lưu ý dòng năm thị − có tác dụng in nội dung biến message HTML Kiểm tra hoạt động portlet Giao diện 22 Ví dụ Portlet – Giao diện hiển thị file view cho phép nhập tên Nhập vào tên nhấn Save portlet hiển thị Hello + name Giao diện 23 Ví dụ Portlet – Giao diện hiển thị thông báo Đỗ Tiến Kiên Trang 36 LIFERAY PORTAL FRAMEWORK CHƯƠNG TẠO MỚI MỘT THEME 4.1 Tạo theme project Liferay IDE Các bước tạo theme IDE − B1: Chọn File → New → Liferay Project − B2: Điền tên project tên hiển thị project vào trường Project name Display name − B3: Lựa chọn Liferay plugins SDK Portal Runtime cài đặt − B4: Chọn Theme trường Plugin type Giao diện 24 Giao diện tạo theme project − B5: Chọn “Next” Đỗ Tiến Kiên Trang 37 LIFERAY PORTAL FRAMEWORK − B6: Chọn theme cha (theme parent) Theme tạo kế thừa kiểu cách từ theme cha, dựa vào để xây dựng theme Mặc định ta chọn, theme _styled, ngồi lựa chọn theme _unstyled – loại theme khơng có kiểu cách − B7: Chọn framework theme Có mẫu framework Freemaker Velocity cho lựa chọn Hoặc chọn JSP để làm framework cho theme Giao diện 25 Giao diện tạo theme project − Bước 8: Chọn “Finish” 4.2 Tạo theme project với dòng lệnh Command Line Có thể tạo theme command line sau: Đỗ Tiến Kiên Trang 38 LIFERAY PORTAL FRAMEWORK − B1: Từ cửa sổ terminal, chuyển đến thư mục chứa theme Để tạo theme, cần thực tạo kịch (script) Cấu trúc câu lệnh sau: create.[sh|bat] [project-name] "[Theme Display Name]" + Đối với Linux Mac OS X, cách làm là: /create.sh my-theme "My Theme" + Trên window tương tự: create.bat my-theme "My Theme" Đỗ Tiến Kiên Trang 39 ... 2.2 Hướng dẫn cài đặt SDK vào Liferay IDE Cài đặt SDK vào Eclipse: − Khởi động Eclipse − Vào Windows >> Preferences >> Liferay Đỗ Tiến Kiên Trang 15 LIFERAY PORTAL FRAMEWORK Giao diện Cài đặt Liferay. .. http://www.oracle.com/technetwork/java/javase/downloads/jdk8downloads-2133151.html 1.2 Hướng dẫn cài đặt Liferay portal 1.2.1 Cài đặt Java, thiết lập biến môi trường JAVA_HOME JRE_HOME − Cài đặt JDK vào hệ thống − Sau cài đặt thành công, ta cần thiết... FRAMEWORK 1.2.2 Cài đặt Liferay − Bước + Giải nén gói cài đặt vừa tải từ trang chủ Sau hoàn tất việc giải nén, ta thư mục liferay- portal -6.2- ce-ga6 có cấu trúc sau: _liferay- portal -6.2- ce-ga6 _data