rojo

原是github上的一个开源项目rojo，本作进行了重构使得它更加高效，功能上也更完善。

问题

使用redis的java客户端jedis的时候需要操作一系列key，保存某个对象的时候，需要把一个个属性组合为key，然后set到redis，较繁琐。

解决方案

rojo是为了简化对象持久化到redis时的操作的，它提供了几个运行时解析的annotation来做这件事情，把用户从设计对象属性的各种key的繁重劳作中解脱出来，而把精力主要放在对象模型的设计上。

使用

直接上代码：

@Entity public class BaseEntity {

@Id(Generator = "common::id")
private long id;
@Value(unique = true)
private String name;

public long getId() {
    return id;
}

public String getName() {
    return name;
}

public void setName(String name) {
    this.name = name;
}

}

这个BaseEntity使用了几个annotation。Entity表示此对象可被持久化到redis；Id指定了此类

对象的唯一id，Id拥有Generator属性，用来定制id生成策略，默认为空字符串，表示需要用户自行管理id。@Id(Generator = "common::id")表示使用common::id这个redis的自增长key来自动生成id Value这个annotation可标注于基本类型（byte、short、int、long、float、double、String）的属性上，以及元素为基本类型的集合（Collection、List、Set）以及Map属性上。 Value拥有几个重要是属性。当被标注的属性为基本类型时，可以指定它的unique为true（默认false）以表达被标注属性的唯一性，比如BaseEntity的name属性就是唯一的，当持久化BaseEntity时，会查看是否已经有一个与此对象相同（equal）的name属性的BaseEntity存在，如存在则持久化失败下面再看另一个Entity。

@Entity(Cache=true) public class TestEntity extends BaseEntity {

@Value
private List<String> list;
@Value
private Set<Float> set;
@Value
private Map<String, Integer> map;
@Value(sort = true, bigFirst = true, size = 100)
private int age;

public void setAge(int age) {
    this.age = age;
}

public int getAge() {
    return age;
}

public void setMap(Map<String, Integer> map) {
    this.map = map;
}

public Map<String, Integer> getMap() {
    return map;
}

public void setSet(Set<Float> set) {
    this.set = set;
}

public Set<Float> getSet() {
    return set;
}

public List<String> getList() {
    return list;
}

public void setList(List<String> strings) {
    this.list = strings;
}

}

这个TestEntity是继承自BaseEntity,因此id和name与BaseEntity相同不在赘述。此外此类

拥有list、set、map和age四个属性，list、set、map分别是元素类型为基本类型的集合类，也在上面曾提过不赘述。看一下age这个属性，标注的Value注解拥有三个属性：sort、bigFirst、 size，用来表达持久化时按照此属性值排序到一个有序列表里面；sort为true表明需要排序， bigFirst指定排序是按照从大到小的顺序，size指明排序列表的总长度（此例中排序列表长100）

看一下如何持久化TestEntity到redis：
    Jedis je = new Jedis("localhost", 6379);
    je.auth("4swardsman");
    je.ping();
    je.flushAll();
    Repository re = new Repository(je);
首先就是创建一个Repository（指定Jedis对象）。很简单。

    TestEntity ss = new TestEntity();
    ss.setName("test" + i);
    ss.setAge(i);
    List<String> l = new ArrayList<String>();
    l.add("fd");
    l.add("akjl;sfd");
    ss.setList(l);
    Map<String, Integer> map = new HashMap<String, Integer>();
    ss.setMap(map);
    map.put("a", 1);
    map.put("b", 2);
    re.writeAndFlush(ss);
	
以上就是初始化一个TestEntity并设置好各属性，最后调用Repository的writeAndFlush

方法写入redis。如果写入成功，返回的long值就是ss对象的id（>0）并且ss的id属性会被正确赋值;如果失败则返回值<=0

    ss = re.get(TestEntity.class, ss.getId());
调用Repository的get方法（指定类型和id）则加载对应此id的TestEntity对象。

此外Repository还有其他几个重要方法：long write(Object entity) 写入对象但不立即flush

一般用于批量保存对象，多个对象写入后，再调用一次flush，会大大提高写入效率；boolean write(Class claz, long id, String p, Object v) 此方法用来更新对象的某个属性但不会立即flush； T get(Class claz, long id, String p)方法可用于获取对象的单个属性；void delete(Class claz, long id) 方法用于删除对象； List rank(Class claz, String p, long start, long end)方法用于获取排名列表。

另外值得一提的还有缓存机制（Entity注释的Cache属性为true则开启缓存），当写入和获取一个对象后，

此对象会立即进入缓存，以便于下次获取时，有更好的效率。

结语

enjoy it.

维多利亚山猫 / rojo

rojo

问题

解决方案

使用

结语

简介

发行版

贡献者

近期动态

维多利亚山猫 / rojo .gitee-modal { width: 500px !important; }

rojo

问题

解决方案

使用

结语

简介

发行版

贡献者

近期动态

搜索帮助

维多利亚山猫 / rojo