Apache JackRabbit Oak là một implementation của Java Content Repository (JCR), một standard API của Java để quản lý và thao tác với kiểu dữ liệu phân cấp. Nó giúp chúng ta có thể quản lý phiên bản, quản lý access và tìm kiếm dữ liệu cho các dữ liệu không có cấu trúc hoặc bán cấu trúc. Trong bài viết này, mình sẽ giới thiệu với các bạn những điểm cơ bản mà các bạn cần biết về Apache JackRabbit Oak để có thể start làm việc với Java Content Repository các bạn nhé!
Đầu tiên, mình sẽ tạo mới một Maven project để làm ví dụ:
Mình sẽ khai báo để sử dụng Apache JackRabbit Oak Maven dependency như sau:
|
1 2 3 4 5 |
<dependency> <groupId>org.apache.jackrabbit</groupId> <artifactId>oak-jcr</artifactId> <version>1.88.0</version> </dependency> |
JCR định nghĩa interface Repository đóng vai trò là một entry point để access vào content repository. Jackrabbit Oak extend interface này sử dụng interface JackrabbitRepository và implementation chính của Repository interface này là class RepositoryImpl.
Jackrabbit Oak định nghĩa content repository sử dụng interface ContentRepository với implementation là class ContentRepositoryImpl. Các bạn có thể access vào content repository này sử dụng entry point Repository được khởi tạo như sau:
|
1 2 3 4 |
Oak oak = new Oak(); Jcr jcr = new Jcr(oak); Repository repository = jcr.createRepository(); |
Class Oak là core content repository engine. Nó sẽ khởi tạo đối tượng của class RepositoryImpl cùng với một số plugin component khác để manage storage, indexing, security và versioning. Class Jcr là một adapter giúp expose class Oak và do đó giúp cho các ứng dụng có thể sử dụng JCR một cách dễ dàng.
Để có thể bắt đầu làm việc với JCR, các bạn cần khởi tạo một session với thông tin credentials như sau:
|
1 2 3 |
Session session = repository.login( new SimpleCredentials("admin", "admin".toCharArray()) ); |
Thông tin credentials admin/admin ở trên sẽ không được validate các bạn nhé. Nó chỉ được validate nếu chúng ta khởi tạo đối tượng của interface Repository với một đối tượng của class SecurityProvider và phải có 1 user đang tồn tại trong hệ thống quản lý thông tin user.
Sau khi đã có đối tượng Session thì các bạn có thể thêm content vào repository sử dụng class Node như sau:
|
1 2 3 4 5 6 7 8 |
Node root = session.getRootNode(); Node hello = root.addNode("hello"); hello.setProperty("message", "Hello from Huong Dan Java!"); hello.setProperty("author", "Khanh Nguyen"); hello.addNode("hello_child").setProperty("desc", "Hello Child"); session.save(); |
Ở đây, mình tạo mới content với node là “hello”. Chúng ta sử dụng đối tượng của class Session để lấy root node và sau đó thì sử dụng phương thức addNode() để thêm node “hello”. Các property của node “hello” bao gồm “message” và “author” cũng đã được thêm sử dụng phương thức setProperty().
Các bạn cũng có thể thêm node con của node “hello” bằng cách sử dụng phương thức addNode() như mình đã làm ở trên nha các bạn!
Sau khi thêm node thì các bạn có thể đọc thông tin node, ví dụ như sau:
|
1 2 3 4 5 |
Node readNode = session.getRootNode().getNode("hello"); System.out.println(readNode.getProperty("message").getString()); System.out.println(readNode.getNode("hello_child").getProperty("desc").getString()); |
Toàn bộ source code ví dụ như sau:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 |
package com.huongdanjava.apache.jackrabbitoak; import javax.jcr.Node; import javax.jcr.Repository; import javax.jcr.RepositoryException; import javax.jcr.Session; import javax.jcr.SimpleCredentials; import org.apache.jackrabbit.oak.Oak; import org.apache.jackrabbit.oak.jcr.Jcr; import org.apache.jackrabbit.oak.security.SecurityProviderImpl; import org.apache.jackrabbit.oak.spi.security.SecurityProvider; public class Application { static void main() throws RepositoryException { Oak oak = new Oak(); Jcr jcr = new Jcr(oak); SecurityProvider securityProvider = new SecurityProviderImpl(); Repository repository = jcr .with(securityProvider) .createRepository(); // Login Session session = repository.login( new SimpleCredentials("admin", "admin".toCharArray()) ); // Create a node Node root = session.getRootNode(); Node hello = root.addNode("hello"); hello.setProperty("message", "Hello from Huong Dan Java!"); hello.setProperty("author", "Khanh Nguyen"); hello.addNode("hello_child").setProperty("desc", "Hello Child"); session.save(); // Read node Node readNode = session.getRootNode().getNode("hello"); System.out.println(readNode.getProperty("message").getString()); System.out.println(readNode.getNode("hello_child").getProperty("desc").getString()); session.logout(); } } |
Kết quả khi mình chạy ví dụ này như sau:
