在Java中,工具类定义了一组公共方法,本文将介绍Java中使用最频繁及最通用的Java工具类。以下工具类、方法按使用流行度排名,下面随动力节点java培训学校小编一起来看看15个超级实用的java开发常用的工具类。
java开发常用的工具类
1、 org.apache.commons.io.IOUtils
介绍
WireMock是用于基于HTTP的API的模拟服务器。 有些人可能会将其视为服务虚拟化工具或模拟服务器。 它使您能够存根所需的API或其他外部依赖项,以加快本地开发速度。 它支持测试真实API无法可靠产生的极端情况和失败模式。 在模拟单元测试和集成测试中的外部依赖关系时,它也很有用。 它与jUnit具有出色的集成。
添加Wiremock依赖性
首先,您将要添加Wiremock依赖项。 您可以下载常规依赖项或包含所有依赖项的胖JAR独立版本。 我们将在此处使用标准依赖项。 将以下依赖项添加到您的build.gradle中
build.gradle
dependencies {
testCompile(‘com.github.tomakehurst:wiremock:2.1.12’)
}
添加Wiremock单元测试
这是完整的单元测试,可用于测试与Wiremock的集成。 该单元测试使用jUnit4规则启动端口8089上的Wiremock服务器,并在每次测试后将其关闭。 我们使用stubFor方法来定义模拟的终点和响应。 我们使用Spring RestTemplate创建一个到模拟服务器的HTTP请求并捕获结果。
WiremockTests.java
public class WiremockTests {
RestTemplate restTemplate;
ResponseEntity response;
@Rule
public WireMockRule wireMockRule = new WireMockRule(wireMockConfig().port(8089).httpsPort(8443));
@Before
public void setup() throws Exception {
restTemplate = new RestTemplate();
response = null;
}
@Test
public void givenWireMockAdminEndpoint_whenGetWithoutParams_thenVerifyRequest() {
RestTemplate restTemplate = new RestTemplate();
response = restTemplate.getForEntity(“http://localhost:8089/__admin”, String.class);
assertThat(“Verify Response Body”, response.getBody().contains(“mappings”));
assertThat(“Verify Status Code”, response.getStatusCode().equals(HttpStatus.OK));
}
@Test
public void givenWireMockEndpoint_whenGetWithoutParams_thenVerifyRequest() {
stubFor(get(urlEqualTo(“/api/resource/”))
.willReturn(aResponse()
.withStatus(HttpStatus.OK.value())
.withHeader(“Content-Type”, TEXT_PLAIN_VALUE)
.withBody(“test”)));
response = restTemplate.getForEntity(“http://localhost:8089/api/resource/”, String.class);
assertThat(“Verify Response Body”, response.getBody().contains(“test”));
assertThat(“Verify Status Code”, response.getStatusCode().equals(HttpStatus.OK));
verify(getRequestedFor(urlMatching(“/api/resource/.*”)));
}
}
您可以运行此测试,如果完成,则您已成功将Wiremock集成到应用程序中。
深入到单元测试
这是一些静态导入,您可以在测试中使用这些静态导入来提高可读性和简洁性。
WiremockTests.java
import static com.github.tomakehurst.wiremock.client.WireMock.*;
import static com.github.tomakehurst.wiremock.core.WireMockConfiguration.wireMockConfig;
import static org.hamcrest.MatcherAssert.assertThat;
import static org.springframework.http.MediaType.TEXT_PLAIN_VALUE;
jUnit4规则
这个jUnit4 @rule将自动管理Wiremock服务器的生命周期以及每个测试用例的启动和关闭Wiremock。 您也可以使用setup()和teardown()方法来实现,但是jUnit4规则更加简洁明了。
WiremockTests.java
@Rule
public WireMockRule wireMockRule = new WireMockRule(wireMockConfig().port(8089).httpsPort(8443));
残端和响应
此代码使用stubFor()方法(已静态导入)定义端点, / api / resource /和纯文本响应主体“ test”。您也可以使用此方法通过更改Content-返回JSON或XML响应。类型和响应主体
WiremockTests.java
stubFor(get(urlEqualTo(“/api/resource/”))
.willReturn(aResponse()
.withStatus(HttpStatus.OK.value())
.withHeader(“Content-Type”, TEXT_PLAIN_VALUE)
.withBody(“test”)));
春天RestTemplate
我们使用Spring RestTemplate类对http:// localhost:8089 / api / resource /执行GET HTTP请求,以打到Wiremock服务器的存根端点。 在这种情况下,我们期望一个String.class实体响应,因为那是我们在stubFor()方法中定义的。 如果您配置了POJO对象,则需要定义一个POJO对象以从存根方法捕获JSON响应。 我们在ResponseEntity对象中捕获响应,该对象捕获响应主体,标头和状态代码以及有关请求的其他信息。
WiremockTests.java
response = restTemplate.getForEntity(“http://localhost:8089/api/resource/”, String.class);
手动启动和停止Wiremock服务器
您可以手动启动和停止Wiremock服务器,而无需使用jUnit4规则来管理生命周期。 当您的应用程序启动时,您可能希望这样做是一种引导方法。
ServiceClass.java
WireMockServer wireMockServer = new WireMockServer(wireMockConfig().port(8089)); //No-args constructor will start on port 8080, no HTTPS
wireMockServer.start();
WireMock.reset();
wireMockServer.stop();
结论
现在,您的项目中已安装Wiremock
closeQuietly:关闭一个IO流、socket、或者selector且不抛出异常,通常放在finally块
toString:转换IO流、 Uri、 byte[]为String
copy:IO流数据复制,从输入流写到输出流中,最大支持2GB
toByteArray:从输入流、URI获取byte[]
write:把字节. 字符等写入输出流
toInputStream:把字符转换为输入流
readLines:从输入流中读取多行数据,返回List
常用注解
@Mapper 只有在接口加上这个注解, MapStruct 才会去实现该接口
@Mapper 里有个 componentModel 属性,主要是指定实现类的类型,一般用到两个
uses:引入class工具类,使用工具类中的类型转换方法
default:默认,可以通过 Mappers.getMapper(Class) 方式获取实例对象
RetrofitUtils
RxJava + Retrofit封装,包含对相同格式请求数据、相同格式返回数据处理,显示Material Design加载dialog,文件上传下载进度展示、全局异常捕捉。
Preview
演示中upload.png为上传图片源文件。
Describe
实现功能:
1、对于相同格式请求数据统一处理;
2、对于相同返回结果进行预处理;
3、显示加载dialog;
4、支持文件带进度上传下载。
主要几个类作用:
1、 RetrofitUtils.java 主要是数据post、get等请求工具类,所有请求调用doHttp()方法。
2、 RetrofitFileUtils.java 主要用于文件下载工具类,包含uploadFile()文件上传、downloadFile()文件下载两个方法。
3、 BaseFileDownload.java 文件下载请求基类,文件下载请求实体类需继承该类实现内部方法。
4、 BaseFileUpload.java 文件上传请求基类,文件上传请求实体类需继承该类实现内部方法。
5、 HttpResultFunc.java 基本数据请求基类,数据请求实体类需继承该类实现内部方法。
6、 RetrofitService.java 主要用于管理请求接口,设置请求地址等。如需修改类名请在调用地方相应进行修改。
spring:在接口的实现类上自动添加注解 @Component,可通过 @Autowired 方式注入
@Mapping:属性映射,若源对象属性与目标对象名字一致,会自动映射对应属性
source:源属性
target:目标属性
dateFormat:String 到 Date 日期之间相互转换,通过 SimpleDateFormat,该值为 SimpleDateFormat 的日期格式
ignore: 忽略这个字段
expression:引入Java表达式,获取数据复制给target
@Mappings:配置多个@Mapping
@MappingTarget 用于更新已有对象
@InheritConfiguration 用于继承配置
Spring 注入的方式
// 默认的方式
PersonConverter INSTANCE = Mappers.getMapper(PersonConverter.class);
@Mapper(componentModel=”spring”)
基础用法
一对一转换
1.两个对象属性名相同,类型可能不同:可以直接写转换方法,不用写映射关系
@Mapper
public interface PersonConverter {
//注入spring
PersonConverter INSTANCE = Mappers.getMapper(PersonConverter.class);
Dto entity2Dto(Entity entity)
}
2.两个对象字段名不同:只需要把属性名不同的字段进行映射,相同的部分不需要处理,如果有不想要映射的属性,可使用ignore
@Mapper(componentModel=”spring”)
public interface PersonConverter {
//映射方法
@Mappings({
@Mapping(source = “birthday”, target = “birth”),
@Mapping(source = “birthday”, target = “birthDateFormat”, dateFormat = “yyyy-MM-dd HH:mm:ss”),
@Mapping(target = “birthExpressionFormat”, expression = “java(org.apache.commons.lang3.time.DateFormatUtils.format(person.getBirthday(),”yyyy-MM-dd HH:mm:ss”))”),
@Mapping(source = “user.age”, target = “age”),
@Mapping(target = “email”, ignore = true)
})
PersonDTO domain2dto(Person person);
List<PersonDTO> domain2dto(List<Person> people);
}
多对一转换
转换是对应的属性,数据类型相同
@Mapper
public interface ItemConverter {
ItemConverter INSTANCE = Mappers.getMapper(ItemConverter.class);
@Mappings({
@Mapping(source = “sku.id”,target = “skuId”),
@Mapping(source = “sku.code”,target = “skuCode”),
@Mapping(source = “sku.price”,target = “skuPrice”),
@Mapping(source = “item.id”,target = “itemId”),
@Mapping(source = “item.title”,target = “itemName”)
})
SkuDTO domain2dto(Item item, Sku sku);
}
有时候, 我们不是想返回一个新的 Bean 对象, 而是希望更新传入对象的一些属性。这个在实际的时候也会经常使用到
@Mapper
public interface AddressMapper {
AddressMapper INSTANCE = Mappers.getMapper(AddressMapper.class);
/**
* Person->DeliveryAddress, 缺失地址信息
* @param person
* @return
*/
DeliveryAddress person2deliveryAddress(Person person);
/**
* 更新, 使用 Address 来补全 DeliveryAddress 信息。 注意注解 @MappingTarget
* @param address
* @param deliveryAddress
*/
void updateDeliveryAddressFromAddress(Address address,
@MappingTarget DeliveryAddress deliveryAddress);
}
一些好用的隐式类型转换:everything-String
@Mapper(componentModel=”spring”)
public interface CarMapper {
//从int到String的转换
@Mapping(source = “price”, numberFormat = “$#.00”)
CarDto carToCarDto(Car car);
@IterableMapping(numberFormat = “$#.00”)
List<String> prices(List<Integer> prices);
}
从BigDecimal到String的转换
@Mapping(source = “power”, numberFormat = “#.##E0”)
CarDto carToCarDto(Car car);
从日期到字符串的转换
@Mapping(source = “manufacturingDate”, dateFormat = “dd.MM.yyyy”)
CarDto carToCarDto(Car car);
@IterableMapping(dateFormat = “dd.MM.yyyy”)
List<String> stringListToDateList(List<Date> dates);
嵌套bean映射
@Mapper
public interface FishTankMapper {
@Mapping(target = “fish.kind”, source = “fish.type”)
@Mapping(target = “fish.name”, ignore = true)
@Mapping(target = “ornament”, source = “interior.ornament”)
@Mapping(target = “material.materialType”, source = “material”)
@Mapping(target = “quality.report.organisation.name”, source = “quality.report.organisationName”)
FishTankDto map( FishTank source );
}
默认值和常量的引入
分别可以通过@Mapping的defaultValue和constant属性指定,当source对象的属性值为null时,如果有指定defaultValue将注入defaultValue的设定的值。constant属性通用用于给target属性注入常量值。
@Mapper
public interface SourceTargetMapper {
SourceTargetMapper INSTANCE = Mappers.getMapper( SourceTargetMapper.class );
@Mapping(target = “stringProperty”, source = “stringProp”, defaultValue = “undefined”)
@Mapping(target = “longProperty”, source = “longProp”, defaultValue = “-1”)
@Mapping(target = “stringConstant”, constant = “Constant Value”)
@Mapping(target = “integerConstant”, constant = “14”)
@Mapping(target = “longWrapperConstant”, constant = “3001”)
@Mapping(target = “dateConstant”, dateFormat = “dd-MM-yyyy”, constant = “09-01-2014”)
@Mapping(target = “stringListConstants”, constant = “jack-jill-tom”)
Target sourceToTarget(Source s);
}
外部转换方法的引入
转换类
@Mapper(componentModel=”spring”,uses = StringListMapper.class)
public interface SourceTargetMapper {
@Mappings({
@Mapping(source = “modifyTime”,target = “modifyTime”,qualifiedByName = “LocalDateTime2String)
})
SkuDto entity2Dto(Entity entity);
}
引入的外部方法类
@Component
@Named(”TypeCoversionMapping”)
public class TypeCoversionMapping {
@Named(“String2Double”)
public Double StringentDouble (String value) {
if(StringUtils.isBlank(value)|| value.equals(”“)){
Return 0.0;
}
return new Double(value);
}
}
copyLarge:同copy,支持2GB以上数据的复制
lineIterator:从输入流返回一个迭代器,根据参数要求读取的数据量,全部读取,如果数据不够,则失败
2、 org.apache.commons.io.FileUtils
deleteDirectory:删除文件夹
readFileToString:以字符形式读取文件内容
deleteQueitly:删除文件或文件夹且不会抛出异常
copyFile:复制文件
writeStringToFile:把字符写到目标文件,如果文件不存在,则创建
forceMkdir:强制创建文件夹,如果该文件夹父级目录不存在,则创建父级
write:把字符写到指定文件中
listFiles:列举某个目录下的文件(根据过滤器)
copyDirectory:复制文件夹
forceDelete:强制删除文件
3、org.apache.commons.lang.StringUtils
isBlank:字符串是否为空 (trim后判断)
isEmpty:字符串是否为空 (不trim并判断)
equals:字符串是否相等
join:合并数组为单一字符串,可传分隔符
split:分割字符串
EMPTY:返回空字符串
trimToNull:trim后为空字符串则转换为null
replace:替换字符串
4、org.apache.http.util.EntityUtils
toString:把Entity转换为字符串
consume:确保Entity中的内容全部被消费。可以看到源码里又一次消费了Entity的内容,假如用户没有消费,那调用Entity时候将会把它消费掉
toByteArray:把Entity转换为字节流
consumeQuietly:和consume一样,但不抛异常
getContentCharset:获取内容的编码
5、 org.apache.commons.lang3.StringUtils
isBlank:字符串是否为空 (trim后判断)
isEmpty:字符串是否为空 (不trim并判断)
equals:字符串是否相等
join:合并数组为单一字符串,可传分隔符
split:分割字符串
EMPTY:返回空字符串
replace:替换字符串
capitalize:首字符大写
6、org.apache.commons.io.FilenameUtils
getExtension:返回文件后缀名
getBaseName:返回文件名,不包含后缀名
getName:返回文件全名
concat:按命令行风格组合文件路径(详见方法注释)
removeExtension:删除后缀名
normalize:使路径正常化
wildcardMatch:匹配通配符
seperatorToUnix:路径分隔符改成unix系统格式的,即/
getFullPath:获取文件路径,不包括文件名
isExtension:检查文件后缀名是不是传入参数(List)中的一个
7、 org.springframework.util.StringUtils
hasText:检查字符串中是否包含文本
hasLength:检测字符串是否长度大于0
isEmpty:检测字符串是否为空(若传入为对象,则判断对象是否为null)
commaDelimitedStringToArray:逗号分隔的String转换为数组
collectionToDelimitedString:把集合转为CSV格式字符串
replace 替换字符串
delimitedListToStringArray:相当于split
uncapitalize:首字母小写
collectionToDelimitedCommaString:把集合转为CSV格式字符串
tokenizeToStringArray:和split基本一样,但能自动去掉空白的单词
8、org.apache.commons.lang.ArrayUtils
contains:是否包含某字符串
addAll:添加整个数组
clone:克隆一个数组
isEmpty:是否空数组
add:向数组添加元素
subarray:截取数组
indexOf:查找某个元素的下标
isEquals:比较数组是否相等
toObject:基础类型数据数组转换为对应的Object数组
9、 org.apache.http.client.utils.URLEncodedUtils
format:格式化参数,返回一个HTTP POST或者HTTP PUT可用application/x-www-form-urlencoded字符串
parse:把String或者URI等转换为List
10、 org.apache.commons.codec.digest.DigestUtils
md5Hex:MD5加密,返回32位字符串
sha1Hex:SHA-1加密
sha256Hex:SHA-256加密
sha512Hex:SHA-512加密
md5:MD5加密,返回16位字符串
11、 org.apache.commons.collections.CollectionUtils
isEmpty:是否为空
select:根据条件筛选集合元素
transform:根据指定方法处理集合元素,类似List的map()
filter:过滤元素,雷瑟List的filter()
find:基本和select一样
collect:和transform 差不多一样,但是返回新数组
forAllDo:调用每个元素的指定方法
isEqualCollection:判断两个集合是否一致
12、 org.apache.commons.lang3.ArrayUtils
contains:是否包含某个字符串
addAll:添加整个数组
clone:克隆一个数组
isEmpty:是否空数组
add:向数组添加元素
subarray:截取数组
indexOf:查找某个元素的下标
isEquals:比较数组是否相等
toObject:基础类型数据数组转换为对应的Object数组
13、org.apache.commons.beanutils.PropertyUtils
getProperty:获取对象属性值
setProperty:设置对象属性值
getPropertyDiscriptor:获取属性描述器
isReadable:检查属性是否可访问
copyProperties:复制属性值,从一个对象到另一个对象
getPropertyDiscriptors:获取所有属性描述器
isWriteable:检查属性是否可写
getPropertyType:获取对象属性类型
14、 org.apache.commons.lang3.StringEscapeUtils
unescapeHtml4:转义html
escapeHtml4:反转义html
escapeXml:转义xml
unescapeXml:反转义xml
escapeJava:转义unicode编码
escapeEcmaScript:转义EcmaScript字符
unescapeJava:反转义unicode编码
escapeJson:转义json字符
escapeXml10:转义Xml10
这个现在已经废弃了,建议使用commons-text包里面的方法。
15、 org.apache.commons.beanutils.BeanUtils
copyPeoperties:复制属性值,从一个对象到另一个对象
getProperty:获取对象属性值
setProperty:设置对象属性值
populate:根据Map给属性复制
copyPeoperty:复制单个值,从一个对象到另一个对象
cloneBean:克隆bean实例
1 . Apache相关IOUtils类
closeQuietly:关闭一个IO流、socket、或者selector且不抛出异常,通常放在finally块
toString:转换IO流、 Uri、 byte[]为String
copy:IO流数据复制,从输入流写到输出流中,最大支持2GB
toByteArray:从输入流、URI获取byte[]
write:把字节. 字符等写入输出流
toInputStream:把字符转换为输入流
readLines:从输入流中读取多行数据,返回List<String>
copyLarge:同copy,支持2GB以上数据的复制
lineIterator:从输入流返回一个迭代器,根据参数要求读取的数据量,全部读取,如果数据不够,则失败
2 . Apache相关FileUtils
deleteDirectory:删除文件夹
readFileToString:以字符形式读取文件内容
deleteQueitly:删除文件或文件夹且不会抛出异常
copyFile:复制文件
writeStringToFile:把字符写到目标文件,如果文件不存在,则创建
forceMkdir:强制创建文件夹,如果该文件夹父级目录不存在,则创建父级
write:把字符写到指定文件中
listFiles:列举某个目录下的文件(根据过滤器)
copyDirectory:复制文件夹
forceDelete:强制删除文件
3. Apache相关org.apache.commons.lang.StringUtils
isBlank:字符串是否为空 (trim后判断)
isEmpty:字符串是否为空 (不trim并判断)
equals:字符串是否相等
join:合并数组为单一字符串,可传分隔符
split:分割字符串
EMPTY:返回空字符串
trimToNull:trim后为空字符串则转换为null
replace:替换字符串
4.Apache 相关EntityUtils
toString:把Entity转换为字符串
consume:确保Entity中的内容全部被消费。可以看到源码里又一次消费了Entity的内容,假如用户没有消费,那调用Entity时候将会把它消费掉
toByteArray:把Entity转换为字节流
consumeQuietly:和consume一样,但不抛异常
getContentCharset:获取内容的编码
5 Apache相关org.apache.commons.lang3.StringUtils
isBlank:字符串是否为空 (trim后判断)
isEmpty:字符串是否为空 (不trim并判断)
equals:字符串是否相等
join:合并数组为单一字符串,可传分隔符
split:分割字符串
EMPTY:返回空字符串
replace:替换字符串
capitalize:首字符大写
6. Apache 相关FilenameUtils
getExtension:返回文件后缀名
getBaseName:返回文件名,不包含后缀名
getName:返回文件全名
concat:按命令行风格组合文件路径(详见方法注释)
removeExtension:删除后缀名
normalize:使路径正常化
wildcardMatch:匹配通配符
seperatorToUnix:路径分隔符改成unix系统格式的,即/
getFullPath:获取文件路径,不包括文件名
isExtension:检查文件后缀名是不是传入参数(List<String>)中的一个
7.Spring相关的org.springframework.util.StringUtils
hasText:检查字符串中是否包含文本
hasLength:检测字符串是否长度大于0
isEmpty:检测字符串是否为空(若传入为对象,则判断对象是否为null)
commaDelimitedStringToArray:逗号分隔的String转换为数组
collectionToDelimitedString:把集合转为CSV格式字符串
replace 替换字符串
delimitedListToStringArray:相当于split
uncapitalize:首字母小写
collectionToDelimitedCommaString:把集合转为CSV格式字符串
tokenizeToStringArray:和split基本一样,但能自动去掉空白的单词
8.Apache相关的 ArrayUtils
contains:是否包含某字符串
addAll:添加整个数组
clone:克隆一个数组
isEmpty:是否空数组
add:向数组添加元素
subarray:截取数组
indexOf:查找某个元素的下标
isEquals:比较数组是否相等
toObject:基础类型数据数组转换为对应的Object数组
9. Apache 相关的CollectionUtils
isEmpty:是否为空
select:根据条件筛选集合元素
transform:根据指定方法处理集合元素,类似List的map()
filter:过滤元素,雷瑟List的filter()
find:基本和select一样
collect:和transform 差不多一样,但是返回新数组
forAllDo:调用每个元素的指定方法
isEqualCollection:判断两个集合是否一致
10 . Apache相关的PropertyUtils
getProperty:获取对象属性值
setProperty:设置对象属性值
getPropertyDiscriptor:获取属性描述器
isReadable:检查属性是否可访问
copyProperties:复制属性值,从一个对象到另一个对象
getPropertyDiscriptors:获取所有属性描述器
isWriteable:检查属性是否可写
getPropertyType:获取对象属性类型
11. Apache相关的StringEscapeUtils
unescapeHtml4:转义html
escapeHtml4:反转义html
escapeXml:转义xml
unescapeXml:反转义xml
escapeJava:转义unicode编码
escapeEcmaScript:转义EcmaScript字符
unescapeJava:反转义unicode编码
escapeJson:转义json字符
escapeXml10:转义Xml10
12.Apache相关的PeopertiesUtils
copyPeoperties:复制属性值,从一个对象到另一个对象
getProperty:获取对象属性值
setProperty:设置对象属性值
populate:根据Map给属性复制
copyPeoperty:复制单个值,从一个对象到另一个对象
cloneBean:克隆bean实例
13. 编码神器 lombok
@Setter 注解在类或字段,注解在类时为所有字段生成setter方法,注解在字段上时只为该字段生成setter方法。
@Getter 使用方法同上,区别在于生成的是getter方法。
@ToString 注解在类,添加toString方法。
@EqualsAndHashCode 注解在类,生成hashCode和equals方法。
@NoArgsConstructor 注解在类,生成无参的构造方法。
@RequiredArgsConstructor 注解在类,为类中需要特殊处理的字段生成构造方法,比如final和被@NonNull注解的字段。
@AllArgsConstructor 注解在类,生成包含类中所有字段的构造方法。
@Data 注解在类,生成setter/getter、equals、canEqual、hashCode、toString方法,如为final属性,则不会为该属性生成setter方法。
@Slf4j 注解在类,生成log变量,严格意义来说是常量。private static final Logger log = LoggerFactory.getLogger(UserController.class);
作者:PrimaryKeyEnoch
链接:https://www.jianshu.com/p/1a9ae5c6584a
来源:简书
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。