https://github.com/jean-merelis/coffeepot-bean-wr
https://github.com/jean-merelis/coffeepot-bean-wr
coffeepot-bean-wr filewriter java java-bean writer
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/jean-merelis/coffeepot-bean-wr
- Owner: jean-merelis
- Created: 2013-06-10T14:21:36.000Z (about 13 years ago)
- Default Branch: master
- Last Pushed: 2018-04-03T12:53:41.000Z (about 8 years ago)
- Last Synced: 2025-07-19T18:43:22.244Z (11 months ago)
- Topics: coffeepot-bean-wr, filewriter, java, java-bean, writer
- Language: Java
- Size: 274 KB
- Stars: 6
- Watchers: 2
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
coffeepot-bean-wr (Writer and Reader)
=====================================
Coffeepot-bean-wr is a simple Java framework for marshalling Java beans to flat file and unmarshal flat file to Java Beans.
Features:
- Support for delimited and fixed length formats.
- Uses Java annotations for mapping.
- Maps unannotated classes dynamically.
- Override annotations dynamically.
- Custom type handlers are supported.
Real examples of use you will find them in [coffeepot-br-sped-fiscal](https://github.com/jean-merelis/coffeepot-br-sped-fiscal) and [coffeepot-br-sintegra](https://github.com/jean-merelis/coffeepot-br-sintegra) projects. The coffeepot-br-sped-fiscal project uses delimited format, and the sintegra project uses FixedLength format.
## Version 2.0.0
In version 2, the type handlers are enhanced with the command feature.
Example:
```java
// DefaultStringHandler has the built-in replace command
@Field(name="descr", commands={@Cmd(name=DefaultStringHandler.CMD_REPLACE, args={"foo", "bar"} )})
```
Download from Maven central
```xml
com.github.jean-merelis
coffeepot-bean-wr
2.0.0-rc.1
```
## Version 1.3.0
Download from Maven central
```xml
com.github.jean-merelis
coffeepot-bean-wr
1.3.0
```
Examples
--------
Mapping
-------
```java
@Record(fields = {
@Field(name = "", id = true, constantValue = "ORDER"),
@Field(name = "id"),
@Field(name = "date"),
@Field(name = "customer", params = {DefaultStringHandler.CMD_REPLACE, "Sr.", "", "CharCase.UPPER"}),
@Field(name = "items")
})
public class Order {
private Integer id;
private Date date;
private String customer;
private List items;
// getters and setters...
}
@Record(fields = {
@Field(name = "", id = true, constantValue = "ITEM"),
@Field(name = "number"),
@Field(name = "product"),
@Field(name = "quantity")
})
public class Item {
private int number;
private String product;
private double quantity;
// getters ... setters...
}
```
Using...
```java
public void test() throws Exception{
Order order = new Order();
order.setCustomer("Sr. John B.");
//add some data
File file = new File("ORDER.tmp");
Writer w = new FileWriter(file);
DelimitedWriter instance = new DelimitedWriter(w);
instance.setDelimiter('|');
instance.setEscape('\\');
instance.setRecordTerminator("|\r\n");
instance.write(order);
w.flush();
w.close();
```
Output:
ORDER|123|2015-03-10T00:04:15|JOHN B.|
ITEM|1|product 1|10|
ITEM|2|product 2|5|
ITEM|3|product 3|2|
Reading
--------------
For simple file structure, i.e. where the file has only one type of record, simply map the fields of the class that represents this record and perform the reading.
If file contains a list of these records you can read with the parseAsListOf.
```java
//Example for a file with a list of the records.
public void read(){
File file = new File("file-with-a-list-of-records.txt");
try (FileReader fr = new FileReader(file)) {
FixedLengthReader reader = new FixedLengthReader(fr);
List records = reader.parseAsListOf(MyRecord.class);
for (MyRecord r: records){
...
}
}
}
```
For more complex structures that have various types of records, it is necessary that the records have an identifier field so it can be possible to instantiate the corresponding class of the record.
The identifier field must have the value that identifies the record in the constantValue property and the id property must be true.
```java
@Record(fields = {
@Field(name = "", constantValue = "01", id = true, length = 2), // identifier field
@Field(name = "value", length = 18)
// ... more fields
})
public class Rec01 {
private String value;
// more fields getters and setters...
...
}
@Record(fields = {
@Field(name = "", constantValue = "AA", id = true, length = 2), // identifier field
@Field(name = "value", length = 18)
// ... more fields
})
public class RecAA {
private String value;
// more fields getters and setters...
...
}
```