转载

[工具资源] benas/random-beans: Because life is too short to generate random Java beans by h...

What is Random Beans ?

Random Beans is a library that generates random Java beans. Generating random data is a common requirement in software testing, and this task can quickly become tedious when the domain model involves many related classes. Random Beans tries to make this task easier.

Why Random Beans?

The java.util.Random API provides 7 methods to generate random data: nextInt() , nextLong() , nextDouble() , nextFloat() , nextBytes() , nextBoolean() and nextGaussian() . What if you need to generate a random String ? Or say a random instance of your domain object? Random Beans provides the EnhancedRandom API that extends java.util.Random with a method called nextObject(Class type) . This method is able to generate a random instance of any arbitrary Java bean:

EnhancedRandom enhancedRandom = EnhancedRandomBuilder.aNewEnhancedRandomBuilder().build(); Person person = enhancedRandom.nextObject(Person.class);

The EnhancedRandomBuilder is the main entry point to configure EnhancedRandom instances with a fluent API. It allows you to set all parameters to control how random data is generated. In most cases, default options are enough and you can use a static import of the EnhancedRandom.random(Class object) method:

Person person = random(Person.class);

This snippet will generate a random instance of the Person type.

Populating a Java object with random data can look easy at first glance, unless your domain model involves many related classes. Let's see a quick example, suppose you have the following domain classes:

[工具资源] benas/random-beans: Because life is too short to generate random Java beans by h...

With Random Beans, generating a random Person object is done with the previous snippet. The library will recursively populate all the object graph. Without Random Beans, you would write something like:

Street street = new Street(12, (byte) 1, "Oxford street"); Address address = new Address(street, "123456", "London", "United Kingdom"); Person person = new Person("Foo", "Bar", "foo.bar@gmail.com", Gender.MALE, address);

And if these classes do not provide constructors with parameters (may be some legacy beans you don't have the control over), you would write:

Street street = new Street(); street.setNumber(12); street.setType((byte) 1); street.setName("Oxford street");  Address address = new Address(); address.setStreet(street); address.setZipCode("123456"); address.setCity("London"); address.setCountry("United Kingdom");  Person person = new Person(); person.setFirstName("Foo"); person.setLastName("Bar"); person.setEmail("foo.bar@gmail.com"); person.setGender(Gender.MALE); person.setAddress(address);

As you can see, Random Beans can tremendously reduce the code of generating random data than doing it by hand.

Quick links

Item	Link
Documentation	https://github.com/benas/random-beans/wiki
Continuous integration	Build job @ Travis CI
Agile Board	Backlog items @ waffle.io
Code coverage
Dependencies

Current version

The current stable version is 3.0.0 :
The current development version is 3.1.0-SNAPSHOT :

You can find more details on how to get startedhere.

Contribution

You are welcome to contribute to the project with pull requests on GitHub.

If you believe you found a bug, please use theissue tracker.

If you have any question, suggestion, or feedback, do not hesitate to use the Gitter channel of the project.

Awesome contributors

Alberto Lagna
Adriano Machado
Eric Taix
Jose Manuel Prieto
Nikola Milivojevic
Rémi Alvergnat
Fred Eckertson
Pascal Schumacher
Vincent Potucek

Thank you all for your contributions!

License

Random Beans is released under the [工具资源] benas/random-beans: Because life is too short to generate random Java beans by h... .

The MIT License  Copyright (c) 2016, Mahmoud Ben Hassine (mahmoud.benhassine@icloud.com)  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

原文 https://github.com/benas/random-beans

正文到此结束