Deserialize: all fields set

Test setup

When I deserialize JSON with optional field set to null

{
  "data": [
    {
      "name": "primitiveInteger",
      "value": 25
    },
    {
      "name": "wrappedInteger",
      "value": 25
    },
    {
      "name": "optionalInteger",
      "value": 25
    },
    {
      "name": "optionalEnum",
      "value": "VALUE1"
    }
  ]
}

Then parser should produce DTO with:

wrappedInteger equals to 25
optionalInteger not present: true
optionalInteger to be equal: 25
optionalEnum to be equal: VALUE1

Deserialize: unknown field

Test setup

When I deserialize JSON with unknown field.

{
  "data": [
    {
      "name": "primitiveInteger",
      "value": 25
    },
    {
      "name": "wrappedInteger",
      "value": 25
    },
    {
      "name": "unknownField",
      "value": "someValue"
    }
  ]
}

Then exception should occur:

optionalInteger to be equal: net.nfon.portal.api.json.deserialize.ApiInvalidJsonException
Of class: net.nfon.portal.api.json.deserialize.ApiInvalidJsonException
and with message: Unexpected field 'unknownField'

Deserialize: primitive field - missing

Test setup

When I deserialize JSON with missing primitive field

{
  "data": [
    {
      "name": "wrappedInteger",
      "value": 25
    }
  ]
}

Then exception should occur:

Of class: net.nfon.portal.api.json.ApiEarlyValidationException
and has violation for path: primitiveInteger
with messages: Value must be provided

Deserialize: wrapper field - missing

Test setup

When I deserialize JSON with missing wrapper field

{
  "data": [
    {
      "name": "primitiveInteger",
      "value": 25
    }
  ]
}

Then exception should occur:

Of class: net.nfon.portal.api.json.ApiEarlyValidationException
and has violation for path: wrappedInteger
with messages: Value must be provided

Deserialize: optional field - missing

Test setup

When I deserialize JSON with missing optional field

{
  "data": [
    {
      "name": "primitiveInteger",
      "value": 25
    },
    {
      "name": "wrappedInteger",
      "value": 25
    }
  ]
}

Then parser should produce DTO with:

primitiveInteger equals to 25
wrappedInteger equals to 25
optionalInteger not present: false

Deserialize: primitive field - set to null

Test setup

When I deserialize JSON with missing primitive field set to null

{
  "data": [
    {
      "name": "primitiveInteger",
      "value": null
    },
    {
      "name": "wrappedInteger",
      "value": 25
    }
  ]
}

I expect exception:

Of class: net.nfon.portal.api.json.deserialize.ApiInvalidJsonException
and with message: Expected value of type Integer for field primitiveInteger.

Deserialize: wrapper field - set to null

Test setup

When I deserialize JSON with wrapper field set to null

{
  "data": [
    {
      "name": "primitiveInteger",
      "value": 25
    },
    {
      "name": "wrappedInteger",
      "value": null
    }
  ]
}

Then parser should produce DTO with:

primitiveInteger equals to 25
wrappedInteger equals to (null)
optionalInteger not present: false

Deserialize: optional field - set to null

Test setup

When I deserialize JSON with optional field set to null

{
  "data": [
    {
      "name": "primitiveInteger",
      "value": 25
    },
    {
      "name": "wrappedInteger",
      "value": 25
    },
    {
      "name": "optionalInteger",
      "value": null
    }
  ]
}

Then parser should produce DTO with:

primitiveInteger equals to 25
wrappedInteger equals to 25
optionalInteger not present: true
optionalInteger to be equal: (null)

Deserialize: primitive field - wrong data type

Test setup

When I deserialize JSON with missing primitive field set to null

{
  "data": [
    {
      "name": "primitiveInteger",
      "value": "here should be a number"
    },
    {
      "name": "wrappedInteger",
      "value": null
    }
  ]
}

I expect exception:

Of class: net.nfon.portal.api.json.deserialize.ApiInvalidJsonException
and with message: Expected class java.lang.Integer in primitiveInteger

Deserialize: wrapper field - wrong data type

Test setup

When I deserialize JSON with missing primitive field set to null

{
  "data": [
    {
      "name": "primitiveInteger",
      "value": 1
    },
    {
      "name": "wrappedInteger",
      "value": "should be a number"
    }
  ]
}

I expect exception:

Of class: net.nfon.portal.api.json.deserialize.ApiInvalidJsonException
and with message: Expected class java.lang.Integer in wrappedInteger

Deserialize: optional field - wrong data type

Test setup

When I deserialize JSON with missing primitive field set to null

{
  "data": [
    {
      "name": "primitiveInteger",
      "value": 1
    },
    {
      "name": "wrappedInteger",
      "value": 23
    },
    {
      "name": "optionalInteger",
      "value": "should be a number"
    }
  ]
}

I expect exception:

Of class: net.nfon.portal.api.json.deserialize.ApiInvalidJsonException
and with message: Expected class java.lang.Integer in optionalInteger

Serialize - completely empty object

Test setup

Having DTO completely empty. When it will be serialized Following JSON should be produced:

{
  "href": null,
  "links": null,
  "data": [
    {
      "name": "primitiveInteger",
      "value": 0
    },
    {
      "name": "wrappedInteger",
      "value": null
    }
  ]
}

Serialize - filled data object

Test setup

Having DTO with data:

primitiveInteger = 11
wrappedInteger = 12
optionalInteger = 13
optionalEnum = value2

When it will be serialized Following JSON should be produced:

{
  "href": null,
  "links": null,
  "data": [
    {
      "name": "primitiveInteger",
      "value": 11
    },
    {
      "name": "wrappedInteger",
      "value": 12
    },
    {
      "name": "optionalInteger",
      "value": 13
    },
    {
      "name": "optionalEnum",
      "value": "value2"
    }
  ]
}

Serialize - optional field has explicit noValue()

Test setup

Having DTO with data:

optionalInteger = noValue()
optionalEnum = noValue()

When it will be serialized Following JSON should be produced:

{
  "href": null,
  "links": null,
  "data": [
    {
      "name": "primitiveInteger",
      "value": 0
    },
    {
      "name": "wrappedInteger",
      "value": null
    }
  ]
}

Serialize - optional field has explicit nullValue()

Test setup

Having DTO with data:

optionalInteger = nullValue()
optionalEnum = nullValue()

When it will be serialized Following JSON should be produced:

{
  "href": null,
  "links": null,
  "data": [
    {
      "name": "primitiveInteger",
      "value": 0
    },
    {
      "name": "wrappedInteger",
      "value": null
    },
    {
      "name": "optionalInteger",
      "value": null
    },
    {
      "name": "optionalEnum",
      "value": null
    }
  ]
}

Service Portal REST API

GET /api/device-types/{deviceTypeName}