PlayMorphia 开源项目教程
1、项目介绍
PlayMorphia 是一个为 Morphia(一个 MongoDB Java 驱动程序的包装器)设计的 Play 2.8.x 模块。Morphia 提供了一种方便的方式来与 MongoDB 数据库进行交互,而 PlayMorphia 则进一步简化了在 Play 框架中使用 Morphia 的过程。
2、项目快速启动
安装
首先,将以下内容添加到你的 build.sbt
文件中:
libraryDependencies ++= Seq(
"com.google.inject" % "guice" % "4.2.3",
"org.mongodb" % "mongo-java-driver" % "3.12.0",
"dev.morphia.morphia" % "core" % "1.5.8"
)
然后,在你的项目目录中创建一个 lib
文件夹,并将 play-morphia.jar
文件复制到其中。
配置
在你的 conf/application.conf
文件中指定 MongoDB 配置:
playmorphia {
mongo {
uri = "mongodb://localhost:27017/yourdatabase"
}
}
创建 MongoClientFactory
创建一个自定义的 MongoClientFactory
类:
import com.mongodb.MongoClient;
import com.mongodb.ServerAddress;
import com.typesafe.config.Config;
import it.unifi.cerm.playmorphia.MongoClientFactory;
import java.util.Arrays;
public class MyMongoClientFactory extends MongoClientFactory {
private Config config;
public MyMongoClientFactory(Config config) {
super(config);
this.config = config;
}
@Override
public MongoClient createClient() throws Exception {
return new MongoClient(Arrays.asList(
new ServerAddress("localhost", 27017)
));
}
@Override
public String getDBName() {
return config.getString("playmorphia.mongo.uri");
}
}
使用 PlayMorphia
创建一个包含存储库类的 repositories
包,每个模型对应一个存储库类。例如,创建一个 UserRepository
类:
import it.unifi.cerm.playmorphia.PlayMorphia;
import models.User;
import org.bson.types.ObjectId;
import javax.inject.Inject;
public class UserRepository {
private final PlayMorphia morphia;
@Inject
public UserRepository(PlayMorphia morphia) {
this.morphia = morphia;
}
public User findById(String id) {
return morphia.datastore().createQuery(User.class)
.field("_id").equal(new ObjectId(id))
.get();
}
public void save(User u) {
morphia.datastore().save(u);
}
}
控制器示例
创建一个 UserController
类:
import play.mvc.Controller;
import play.mvc.Result;
import views.html.modifyUserView;
import javax.inject.Inject;
public class UserController extends Controller {
@Inject
private UserRepository userRepository;
public Result modifyUser(String id) {
User u = userRepository.findById(id);
return ok(modifyUserView.render(u));
}
}
3、应用案例和最佳实践
应用案例
PlayMorphia 可以用于各种需要与 MongoDB 进行交互的 Web 应用。例如,一个社交网络应用可以使用 PlayMorphia 来管理用户数据、帖子、评论等。
最佳实践
- 合理设计数据模型:确保你的数据模型能够有效地映射到 MongoDB 的文档结构。
- 使用索引:为经常查询的字段创建索引,以提高查询性能。
- 异常处理:在数据操作中加入适当的异常处理,以应对可能的错误情况。
4、典型生态项目
PlayMorphia 可以与其他 Play 框架的模块和工具结合使用,例如:
- Play-Json