1.0.0-2 • Published 2 years ago
at-json v1.0.0-2
at-json
A declarative mapper to and from JSON.
Installation
npm install at-json
Usage
import { JsonClass, JsonProperty, JsonArray, JsonComplexProperty, JsonMapper } from 'at-json';
@JsonClass()
class Payload {
// maps a "name" property to the field
@JsonProperty() name: string;
// maps a "SN" property to the field "surname"
@JsonProperty('SN') surname: string;
// maps an array of numbers named "numbers" to the field
@JsonArray() numbers: number[];
// maps a complex type recursively
@JsonComplexProperty(SubClass) sub: SubClass;
}
@JsonClass()
class SubClass {
// other mappings
@JsonProperty() x: number;
@JsonProperty() y: number;
get norm(): double {
return Math.sqrt(this.x * this.x + this.y * this.y);
}
}
// ...
const payloadObject = {
name: 'name',
SN: 'surname',
numbers: [1,2,3],
sub: {
x: 1,
y: 2
}
};
// you can deserialize objects, or JSON strings too!
const mapped = JsonMapper.deserialize(Payload, payloadObject);
const mappedFromString = JsonMapper.deserialize(Payload, JSON.stringify(payloadObject));
// mapped is a Payload instance
expect(mapped instanceof Payload).toBe(true);
// fields are deserialized accordingly to the names specified in decorators
expect(mapped.name).toBe('name');
expect(mapped.surname).toBe('surname');
// mapped.sub is a SubClass instance
expect(mapped.sub instanceof SubClass).toBe(true);
expect(mapped.sub.norm).toBe(Math.sqrt(5));
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate.
License
1.0.0-1
2 years ago
1.0.0-0
2 years ago
1.0.0-2
2 years ago
0.0.33
4 years ago
0.0.32
4 years ago
0.0.32-rc.1
4 years ago
0.0.32-rc.0
4 years ago
0.0.31
4 years ago
0.0.30
4 years ago
0.0.29
4 years ago
0.0.27
4 years ago
0.0.28
4 years ago
0.0.27-rc.1
4 years ago
0.0.27-rc.0
4 years ago
0.0.26
4 years ago
0.0.25
4 years ago
0.0.24
5 years ago
0.0.23
5 years ago
0.0.22
5 years ago
0.0.21
5 years ago
0.0.20
5 years ago
0.0.19
5 years ago
0.0.18
6 years ago
0.0.17
6 years ago
0.0.16
6 years ago
0.0.1-5.1
6 years ago
0.0.15
6 years ago
0.0.14
6 years ago
0.0.13
6 years ago
0.0.12
6 years ago
0.0.11
6 years ago
0.0.10
6 years ago
0.0.9
6 years ago
0.0.8
6 years ago
0.0.7
6 years ago
0.0.6
6 years ago
0.0.5
6 years ago
0.0.4
6 years ago
0.0.3
6 years ago
0.0.2
6 years ago
0.0.1
6 years ago