mongodb快速入门
通过mongdb初始，我们对mongodb有了一个基本的认识，接下来看一下究竟如何使用。
本部分包含的内容包括：
1、mongodb在mac的安装，命令行及客户端工具的简单介绍；
2、在spring中如何使用mongodb，增删改查示例；
3、mongodb原生api的使用，增删改查示例；
4、mongodb连接池的学习；
-------------------------------------------------------------------------------------------------------------------------------------------------
1、下载安装及工具简单介绍
1、从官网下载安装包https://www.mongodb.com/download-center，解压到本地合适文件夹；
2、手动创建data目录以及logs跟logs/mongodb.log文件；
3、在mongodb安装目录创建etc目录，并在其下创建mongodb.conf文件，内容见下；
4、配置环境变量，export PATH=${PATH}:/software/mongodb-osx-x86_64-4.0.10/bin;
5、到bin目录执行./mongod -f ../etc/mongod.conf启动，或者nohup ./mongod -f ../etc/mongod.conf & 后台启动；
mongodb.conf内容如下：
#mongodb config file dbpath=/software/mongodb-osx-x86_64-4.0.10/data/db/ #数据存放目录 logpath=/software/mongodb-osx-x86_64-4.0.10/logs/mongod.log #日志存放目录 logappend = true #以天为单位，自动切割日志 port = 27017 fork = true auth = false
下载官方工具MongoDB Compass，启动后进行连接，过程略；
命令行及compass工具使用：
命令行：
1、连接数据库，./mongo ip地址:端口号，连接本地可以省略地址跟端口号，注意启动命令是mongod，连接命令是mongo
2、查看当前有几个数据库，show dbs ，类似于mysql的show database；
3、切换数据库，use 库名；
4、查看库中所有表，show collections;若当前库没有表，则显示为空；
5、往表中随便插入一条数据，db.myusers.insert({"name":"张三"})
这里我们注意一下，show dbs的时候，并没有mytest这个库，我们直接use mytest，mongodb并没有报错，而且我们可以直接insert；这一点跟mysql是不一样的，mongodb可以不用创建库，直接use之后insert的时候回自动创建该库，若没有insert操作，该库并不会实际创建；而且可以看到，对于插入的数据，mongodb自动生成了id；
compass连接本地，可以在左侧看到当前实例的所有库，右侧则为查询展示内容，list为mongo的josn视图，table为将数据展示为传统的关系库表视图；，上方的filter可以书写查询条件，另外还有查询的执行计划，索引等内容，稍后详述；我们刚才加入的数据：
2、spring 集成mongodb使用
目标：利用spring提供的mongodb的api实现对单表的增删改查
1、创建spring boot项目，pom文件添加
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-mongodb</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.mongodb</groupId>
<artifactId>mongo-java-driver</artifactId>
<version>3.8.0</version>
</dependency>
2、application.yml中添加
spring:
data:
mongodb:
uri: mongodb://localhost:27017/wzy
3、初始化数据：
数据脚本如下：本文所采用的数据已被本地多次测试修改，但结构未发生变化，脚本参考如下：
db.users.drop();
var user1 = {
"username" : "张三",
"country" : "china",
"address" : {
"aCode" : "411000",
"add" : "长沙"
},
"favorites" : {
"movies" : ["杀破狼2","战狼","雷神1"],
"cites" : ["长沙","深圳","上海"]
},
"age" : 18,
"salary":NumberDecimal("18889.09"),
"lenght" :1.79
};
var user2 = {
"username" : "李四",
"country" : "English",
"address" : {
"aCode" : "311000",
"add" : "地址"
},
"favorites" : {
"movies" : ["复仇者联盟","战狼","雷神1"],
"cites" : ["西安","东京","上海"]
},
"age" : 24,
"salary":NumberDecimal("7889.09"),
"lenght" :1.35
};
var user3 ={
"username" : "王五",
"country" : "japan",
"address" : {
"aCode" : "411000",
"add" : "长沙"
},
"favorites" : {
"movies" : ["肉蒲团","一路向西","倩女幽魂"],
"cites" : ["东莞","深圳","东京"]
},
"age" : 22,
"salary":NumberDecimal("6666.66"),
"lenght" :1.85
};
var user4 =
{
"username" : "马六",
"country" : "USA",
"address" : {
"aCode" : "411000",
"add" : "长沙"
},
"favorites" : {
"movies" : ["蜘蛛侠","钢铁侠","蝙蝠侠"],
"cites" : ["青岛","东莞","上海"]
},
"age" : 20,
"salary":NumberDecimal("6398.22"),
"lenght" :1.77
};
var user5 =
{
"username" : "test",
"country" : "UK",
"address" : {
"aCode" : "411000",
"add" : "TEST"
},
"favorites" : {
"movies" : ["蜘蛛侠","钢铁侠","蝙蝠侠"],
"cites" : ["青岛","东莞","上海"]
},
"salary":NumberDecimal("1969.88")
};
db.users.insert(user1);
db.users.insert(user2);
db.users.insert(user3);
db.users.insert(user4);
db.users.insert(user5);
4、创建实体bean
其中，@Getter等注解来自lombok
@ToString
@Getter
@Setter
@Generated
@Builder
@Document(collection = "users")
public class User {
@Id
private String id;
//姓名
@Field("username")
private String username;
//国籍
private String country;
//年龄
private int age;
//薪水
private BigDecimal salary;
//身高
private Double length;
//地址
private Address address;
//爱好
private HashMap favourites;
}
5、创建service
@Service
public class MongoTestService {
@Autowired
private MongoTemplate mongoTemplate;
//查询
public User getUserByName(String name){
Query query = new Query();
query.addCriteria(Criteria.where("username").is(name));
User user = mongoTemplate.findOne(query, User.class);
return user;
}
//插入
public void insertUser(){
HashMap map = new HashMap();
map.put("movies", Arrays.asList("决战天门","倩女幽魂"));
map.put("cities", Arrays.asList("大理","拉萨"));
User user = User.builder()
.username("luochengwu")
.age(20)
.country("china")
.address(new Address("01002",""))
.favourites(map)
.salary(new BigDecimal("2345.67"))
.build();
mongoTemplate.save(user);
}
//更新
public void updateUser(){
//把李四年龄修改为30
Query query1 = new Query();
query1.addCriteria(Criteria.where("username").is("李四"));
List<User> lisi1 = mongoTemplate.find(query1,User.class);
System.out.println("before update --------"+lisi1.get(0).toString());
Update update1 = new Update();
update1.set("age",30);
UpdateResult result =mongoTemplate.updateMulti(query1,update1,User.class);
List<User> lisi11 = mongoTemplate.find(query1,User.class);
System.out.println("after update --------"+result);
System.out.println("after user --------"+lisi11.get(0));
//略复杂的条件
//住在横滨的日本人，喜欢的城市添加东京
Query query2 = new Query();
query2.addCriteria(Criteria.where("country").is("japan").and("address.add").is("横滨"));
User user1 = mongoTemplate.findOne(query2,User.class);
System.out.println("before update ------"+user1);
Update update2 = new Update();
update2.addToSet("favourites.cities","东京");
UpdateResult result2 = mongoTemplate.updateMulti(query2,update2,User.class);
User user2 = mongoTemplate.findOne(query2,User.class);
System.out.println("after update --------"+result2);
System.out.println("after user --------"+user2);
}
//删除
public void deleteUser(){
//删掉国籍为uk，且年龄为22的人
Query query = new Query();
query.addCriteria(Criteria.where("country").is("UK").and("age").is(22));
User user = mongoTemplate.findOne(query,User.class);
System.out.println("待删除的用户 ------" + user);
DeleteResult result = mongoTemplate.remove(query,User.class);
System.out.println("remove response ------"+ result);
User delUser = mongoTemplate.findOne(query,User.class);
System.out.println("query after delete ------" + delUser);
}
}
1、java跟mongodb数据类型转换的问题，一般java的数据类型跟数据库(比如mysql)的数据类型对应关系，数据库驱动已经帮我们做好了，那个“方言”的配置就是。mongodb貌似做的不全，有些是需要我们自己进行配置的，比如本例中的BigDecimal跟Decimal128;
默认报错：
解决办法：添加converter
@Configuration
public class MongodbConfig extends AbstractMongoConfiguration {
@Value("${spring.data.mongodb.uri}")
private String dburi ;
@Override
public MongoClient mongoClient() {
MongoClient mongoClient = new MongoClient();
return mongoClient;
}
@Override
protected String getDatabaseName() {
int index = dburi.lastIndexOf("/")+1;
return dburi.substring(index);
}
@Bean
public MappingMongoConverter mappingMongoConverter(){
DefaultDbRefResolver dbRefResolver = new DefaultDbRefResolver(this.mongoDbFactory());
MappingMongoConverter converter = new MappingMongoConverter(dbRefResolver, this.mongoMappingContext());
List<Object> list = new ArrayList<>();
list.add(new BigDecimalToDecimal128Converter());
list.add(new Decimal128ToBigDecimal());
converter.setCustomConversions(new MongoCustomConversions(list));
return converter;
}
@Bean
public MongoMappingContext mongoMappingContext(){
MongoMappingContext mappingContext = new MongoMappingContext();
return mappingContext;
}
@Bean
public MongoTemplate mongoTemplate(){
return new MongoTemplate(this.mongoDbFactory(),this.mappingMongoConverter());
}
}
2、map跟hashmap的问题，被更新字段的数据类型必须明确。写Map报错：
解决办法，将相关字段改为实现类HashMap，而不是用接口；这个当时困扰了一下，开始的时候没看懂这个异常；
3、double跟Double的问题，由于mongodb数据结构的自由，有些记录可能缺少某些字段，也就是字段值为null，如果该字段为引用类型是没有问题的，但若该字段为int，double等基本数据类型时，会发生类型转换错误；
解决办法，将字段改为包装类；so，pojo的各个属性最好为引用类型而不是简单类型，在使用关系数据库的时候也应该如此，有些字段(比如年龄，分数，价钱等)，没填写跟值为0显然是两个概念。
3、mongodb自带的原生api增删改查
public class DocumentTest {
private Logger log = LoggerFactory.getLogger(DocumentTest.class);
private MongoDatabase db;
private MongoCollection<Document> collection;
private MongoClient client;
@Before
public void init(){
client = new MongoClient("localhost");
db = client.getDatabase("wzy");
collection = db.getCollection("users");
}
//新增
@Test
public void insertTest(){
Document doc1 = new Document();
doc1.append("username","cang");
doc1.append("age",20);
doc1.append("country","japan");
doc1.append("length",1.77f);
doc1.append("salary",new BigDecimal("6565.22"));
//对象
Map<String,String> address = new HashMap<>();
address.put("aCode","01001");
address.put("add","大板");
doc1.append("address",address);
//数组
Map<String,Object> fav = new HashMap<>();
fav.put("movies", Arrays.asList("大决战","天龙"));
fav.put("citys", Arrays.asList("杭州","苏州"));
doc1.append("favourites",fav);
collection.insertOne(doc1);
// collection.insertMany();
}
//查询
@Test
public void queryTest(){//{"favourites.cites":["长沙","上海"]}
List<Document> list = new ArrayList<>();
//mongo查询结果遍历接口
Block<Document> block = new Block<Document>() {
@Override
public void apply(Document document) {
log.info(document.toJson());
list.add(document);
}
};
FindIterable<Document> find1 = collection.find(all("favourites.cites",Arrays.asList("长沙","上海")));
find1.forEach(block);
log.info("结果有{}条", list.size());
list.removeAll(list);
//like '%s%',需要正则, like '%s%' and (country = 'English' or country='USA')
String regexStr = ".*s.*"; //s前后都可以有任意字符
Bson regex = regex("username",regexStr);
Bson or = or(eq("country","English"),eq("country","USA"));
FindIterable<Document> find2 = collection.find(and(regex,or));
find2.forEach(block);
log.info("查询结果有{}条",list.size());
}
//更新
@Test
public void updateTest(){
//更新单个字段
UpdateResult result = collection.updateMany(eq("username","cang"),new Document("$set",new Document("age",6)));
//替换整个文档
// UpdateResult result = collection.updateMany(eq("username","cang"),new Document(new Document("age",6)));
UpdateResult result1 = collection.updateMany(eq("favourites.citys","杭州"),
addEachToSet("favourites.movies",Arrays.asList("小电影")));
log.info("更新了{}条",result1.getModifiedCount());
}
//删除
@Test
public void deleteTest(){
DeleteResult result = collection.deleteMany(Filters.eq("username","luochengwu"));
log.info("删除了{}行",result.getDeletedCount());
DeleteResult result1 = collection.deleteMany(and(gt("age",8),lt("age",28)));
log.info("删除了{}行",result1.getDeletedCount());
}
}
问题：经过前边对数据类型的趟坑，这里倒是没遇到什么异常；该部分最大的问题是对mongodb提供的原生api的不熟悉，尤其多个条件如何组合，and，or，exist的如何表达，文档整体更新跟局部更新如何处理等，这个感觉没什么办法，只能多多使用慢慢熟悉了；
4、mongodb连接池
mongodb团队已经帮我们做好了一个连接池，以供我们直接使用。使用方式也很简单，就是在获取client的时候将连接池参数对象传进去即可。
连接池参数的设置是通过构造器模式来实现的，因为参数实在是比较多，我们可以根据自己需要进行自由设置。比如在第3步的单元测试类中，我们可以这样使用连接池：
@Before
public void init(){
MongoClientOptions mco = MongoClientOptions.builder()
.writeConcern(WriteConcern.ACKNOWLEDGED)
.minConnectionsPerHost(100)
.threadsAllowedToBlockForConnectionMultiplier(5)
.maxWaitTime(120000)
.connectTimeout(10000)
.build();
client = new MongoClient(new ServerAddress("localhost",27017), mco);
db = client.getDatabase("wzy");
collection = db.getCollection("users");
}
-------------------------------------------------------------------------------------------------
以上，我们练习了spring template跟mongo原生api两种操作mongodb的方式。使用起来，要跟sql一样有查询条件，有and，or，like等，但显然，其语法跟细节跟sql是完全不想关的，精通sql跟熟练使用mongodb没有半毛钱关系。实际上，mongodb是有挺多细节需要注意的，我们稍后将在典型场景中进行详述。
