test_class.declarator: THING_IDS = JsonFactory.newArrayBuilder()
              .add(TestConstants.Thing.THING_ID.toString())
              .add(TestConstants.Thing.THING_ID.getNamespace() + ":AnotherThingId")
              .build()
test_class.modifier: private static final
test_class.original_string: private static final JsonArray THING_IDS = JsonFactory.newArrayBuilder()
              .add(TestConstants.Thing.THING_ID.toString())
              .add(TestConstants.Thing.THING_ID.getNamespace() + ":AnotherThingId")
              .build();
test_class.type: JsonArray
test_class.var_name: THING_IDS
test_class.declarator: THING_IDS_WITH_DISTINCT_NAMESPACE = JsonFactory.newArrayBuilder()
              .add(TestConstants.Thing.THING_ID.toString())
              .add(TestConstants.Thing.THING_ID + "1")
              .add(TestConstants.Thing.THING_ID + "2")
              .build()
test_class.modifier: private static final
test_class.original_string: private static final JsonArray THING_IDS_WITH_DISTINCT_NAMESPACE = JsonFactory.newArrayBuilder()
              .add(TestConstants.Thing.THING_ID.toString())
              .add(TestConstants.Thing.THING_ID + "1")
              .add(TestConstants.Thing.THING_ID + "2")
              .build();
test_class.type: JsonArray
test_class.var_name: THING_IDS_WITH_DISTINCT_NAMESPACE
test_class.declarator: SELECTED_FIELDS = "field1,field2,field3"
test_class.modifier: private static final
test_class.original_string: private static final String SELECTED_FIELDS = "field1,field2,field3";
test_class.type: String
test_class.var_name: SELECTED_FIELDS
test_class.declarator: KNOWN_JSON = JsonFactory.newObjectBuilder()
              .set(ThingCommand.JsonFields.TYPE, RetrieveThings.TYPE)
              .set(RetrieveThings.JSON_THING_IDS, THING_IDS)
              .build()
test_class.modifier: private static final
test_class.original_string: private static final JsonObject KNOWN_JSON = JsonFactory.newObjectBuilder()
              .set(ThingCommand.JsonFields.TYPE, RetrieveThings.TYPE)
              .set(RetrieveThings.JSON_THING_IDS, THING_IDS)
              .build();
test_class.type: JsonObject
test_class.var_name: KNOWN_JSON
test_class.declarator: KNOWN_JSON_WITH_DISTINCT_NAMESPACE = JsonFactory.newObjectBuilder()
              .set(ThingCommand.JsonFields.TYPE, RetrieveThings.TYPE)
              .set(RetrieveThings.JSON_THING_IDS, THING_IDS_WITH_DISTINCT_NAMESPACE)
              .set(RetrieveThings.JSON_NAMESPACE, "example.com")
              .build()
test_class.modifier: private static final
test_class.original_string: private static final JsonObject KNOWN_JSON_WITH_DISTINCT_NAMESPACE = JsonFactory.newObjectBuilder()
              .set(ThingCommand.JsonFields.TYPE, RetrieveThings.TYPE)
              .set(RetrieveThings.JSON_THING_IDS, THING_IDS_WITH_DISTINCT_NAMESPACE)
              .set(RetrieveThings.JSON_NAMESPACE, "example.com")
              .build();
test_class.type: JsonObject
test_class.var_name: KNOWN_JSON_WITH_DISTINCT_NAMESPACE
test_class.declarator: KNOWN_JSON_WITH_FIELD_SELECTION = JsonFactory.newObjectBuilder()
              .set(ThingCommand.JsonFields.TYPE, RetrieveThings.TYPE)
              .set(RetrieveThings.JSON_THING_IDS, THING_IDS)
              .set(RetrieveThings.JSON_SELECTED_FIELDS, SELECTED_FIELDS)
              .build()
test_class.modifier: private static final
test_class.original_string: private static final JsonObject KNOWN_JSON_WITH_FIELD_SELECTION = JsonFactory.newObjectBuilder()
              .set(ThingCommand.JsonFields.TYPE, RetrieveThings.TYPE)
              .set(RetrieveThings.JSON_THING_IDS, THING_IDS)
              .set(RetrieveThings.JSON_SELECTED_FIELDS, SELECTED_FIELDS)
              .build();
test_class.type: JsonObject
test_class.var_name: KNOWN_JSON_WITH_FIELD_SELECTION
test_class.declarator: JSON_PARSE_OPTIONS =
              JsonFactory.newParseOptionsBuilder().withoutUrlDecoding().build()
test_class.modifier: private static final
test_class.original_string: private static final JsonParseOptions JSON_PARSE_OPTIONS =
              JsonFactory.newParseOptionsBuilder().withoutUrlDecoding().build();
test_class.type: JsonParseOptions
test_class.var_name: JSON_PARSE_OPTIONS
test_class.file: signals/commands/things/src/test/java/org/eclipse/ditto/signals/commands/things/query/RetrieveThingsTest.java
test_class.identifier: RetrieveThingsTest
test_case.body: @Test(expected = NullPointerException.class)
      public void initializationWithNullForThingIdsStringArrayThrowsNullPointerException(){
          RetrieveThings.getBuilder((String[]) null).build();
      }
test_case.class_method_signature: RetrieveThingsTest.initializationWithNullForThingIdsStringArrayThrowsNullPointerException()
test_case.full_signature: @Test(expected = NullPointerException.class) public void initializationWithNullForThingIdsStringArrayThrowsNullPointerException()
test_case.identifier: initializationWithNullForThingIdsStringArrayThrowsNullPointerException
test_case.invocations: build getBuilder
test_case.modifiers: @Test(expected = NullPointerException.class) public
test_case.parameters: ()
test_case.return: void
test_case.signature: void initializationWithNullForThingIdsStringArrayThrowsNullPointerException()
focal_class.declarator: NAME = "retrieveThings"
focal_class.modifier: public static final
focal_class.original_string: public static final String NAME = "retrieveThings";
focal_class.type: String
focal_class.var_name: NAME
focal_class.declarator: TYPE = TYPE_PREFIX + NAME
focal_class.modifier: public static final
focal_class.original_string: public static final String TYPE = TYPE_PREFIX + NAME;
focal_class.type: String
focal_class.var_name: TYPE
focal_class.declarator: JSON_THING_IDS =
              JsonFactory.newJsonArrayFieldDefinition("thingIds", FieldType.REGULAR, JsonSchemaVersion.V_1,
                      JsonSchemaVersion.V_2)
focal_class.modifier: public static final
focal_class.original_string: public static final JsonFieldDefinition<JsonArray> JSON_THING_IDS =
              JsonFactory.newJsonArrayFieldDefinition("thingIds", FieldType.REGULAR, JsonSchemaVersion.V_1,
                      JsonSchemaVersion.V_2);
focal_class.type: JsonFieldDefinition<JsonArray>
focal_class.var_name: JSON_THING_IDS
focal_class.declarator: JSON_SELECTED_FIELDS =
              JsonFactory.newStringFieldDefinition("selectedFields", FieldType.REGULAR, JsonSchemaVersion.V_1,
                      JsonSchemaVersion.V_2)
focal_class.modifier: static final
focal_class.original_string: static final JsonFieldDefinition<String> JSON_SELECTED_FIELDS =
              JsonFactory.newStringFieldDefinition("selectedFields", FieldType.REGULAR, JsonSchemaVersion.V_1,
                      JsonSchemaVersion.V_2);
focal_class.type: JsonFieldDefinition<String>
focal_class.var_name: JSON_SELECTED_FIELDS
focal_class.declarator: JSON_NAMESPACE =
              JsonFactory.newStringFieldDefinition("namespace", FieldType.REGULAR, JsonSchemaVersion.V_1,
                      JsonSchemaVersion.V_2)
focal_class.modifier: static final
focal_class.original_string: static final JsonFieldDefinition<String> JSON_NAMESPACE =
              JsonFactory.newStringFieldDefinition("namespace", FieldType.REGULAR, JsonSchemaVersion.V_1,
                      JsonSchemaVersion.V_2);
focal_class.type: JsonFieldDefinition<String>
focal_class.var_name: JSON_NAMESPACE
focal_class.declarator: thingIds
focal_class.modifier: private final
focal_class.original_string: private final List<ThingId> thingIds;
focal_class.type: List<ThingId>
focal_class.var_name: thingIds
focal_class.declarator: selectedFields
focal_class.modifier: @Nullable private final
focal_class.original_string: @Nullable private final JsonFieldSelector selectedFields;
focal_class.type: JsonFieldSelector
focal_class.var_name: selectedFields
focal_class.declarator: namespace
focal_class.modifier: @Nullable private final
focal_class.original_string: @Nullable private final String namespace;
focal_class.type: String
focal_class.var_name: namespace
focal_class.file: signals/commands/things/src/main/java/org/eclipse/ditto/signals/commands/things/query/RetrieveThings.java
focal_class.identifier: RetrieveThings
focal_class.interfaces: implements ThingQueryCommand<RetrieveThings>, WithNamespace
focal_class.class_method_signature: RetrieveThings.RetrieveThings(final Builder builder)
focal_class.full_signature: private  RetrieveThings(final Builder builder)
focal_class.identifier: RetrieveThings
focal_class.modifiers: private
focal_class.parameters: (final Builder builder)
focal_class.signature:  RetrieveThings(final Builder builder)
focal_class.class_method_signature: RetrieveThings.RetrieveThings(final List<ThingId> thingIds,
              @Nullable final JsonFieldSelector selectedFields,
              @Nullable final String namespace,
              final DittoHeaders dittoHeaders)
focal_class.full_signature: private  RetrieveThings(final List<ThingId> thingIds,
              @Nullable final JsonFieldSelector selectedFields,
              @Nullable final String namespace,
              final DittoHeaders dittoHeaders)
focal_class.identifier: RetrieveThings
focal_class.modifiers: private
focal_class.parameters: (final List<ThingId> thingIds,
              @Nullable final JsonFieldSelector selectedFields,
              @Nullable final String namespace,
              final DittoHeaders dittoHeaders)
focal_class.signature:  RetrieveThings(final List<ThingId> thingIds,
              @Nullable final JsonFieldSelector selectedFields,
              @Nullable final String namespace,
              final DittoHeaders dittoHeaders)
focal_class.class_method_signature: RetrieveThings.checkForDistinctNamespace(@Nullable final String providedNamespace,
              final Collection<ThingId> thingIds)
focal_class.full_signature: @Nullable private static String checkForDistinctNamespace(@Nullable final String providedNamespace,
              final Collection<ThingId> thingIds)
focal_class.identifier: checkForDistinctNamespace
focal_class.modifiers: @Nullable private static
focal_class.parameters: (@Nullable final String providedNamespace,
              final Collection<ThingId> thingIds)
focal_class.return: String
focal_class.signature: String checkForDistinctNamespace(@Nullable final String providedNamespace,
              final Collection<ThingId> thingIds)
focal_class.class_method_signature: RetrieveThings.getBuilder(final String... thingIds)
focal_class.full_signature: @Deprecated public static Builder getBuilder(final String... thingIds)
focal_class.identifier: getBuilder
focal_class.modifiers: @Deprecated public static
focal_class.parameters: (final String... thingIds)
focal_class.return: Builder
focal_class.signature: Builder getBuilder(final String... thingIds)
focal_class.class_method_signature: RetrieveThings.getBuilder(final ThingId... thingIds)
focal_class.full_signature: public static Builder getBuilder(final ThingId... thingIds)
focal_class.identifier: getBuilder
focal_class.modifiers: public static
focal_class.parameters: (final ThingId... thingIds)
focal_class.return: Builder
focal_class.signature: Builder getBuilder(final ThingId... thingIds)
focal_class.class_method_signature: RetrieveThings.getBuilder(final List<ThingId> thingIds)
focal_class.full_signature: public static Builder getBuilder(final List<ThingId> thingIds)
focal_class.identifier: getBuilder
focal_class.modifiers: public static
focal_class.parameters: (final List<ThingId> thingIds)
focal_class.return: Builder
focal_class.signature: Builder getBuilder(final List<ThingId> thingIds)
focal_class.class_method_signature: RetrieveThings.getBuilder(final RetrieveThings retrieveThings)
focal_class.full_signature: public static Builder getBuilder(final RetrieveThings retrieveThings)
focal_class.identifier: getBuilder
focal_class.modifiers: public static
focal_class.parameters: (final RetrieveThings retrieveThings)
focal_class.return: Builder
focal_class.signature: Builder getBuilder(final RetrieveThings retrieveThings)
focal_class.class_method_signature: RetrieveThings.fromJson(final String jsonString, final DittoHeaders dittoHeaders)
focal_class.full_signature: public static RetrieveThings fromJson(final String jsonString, final DittoHeaders dittoHeaders)
focal_class.identifier: fromJson
focal_class.modifiers: public static
focal_class.parameters: (final String jsonString, final DittoHeaders dittoHeaders)
focal_class.return: RetrieveThings
focal_class.signature: RetrieveThings fromJson(final String jsonString, final DittoHeaders dittoHeaders)
focal_class.class_method_signature: RetrieveThings.fromJson(final JsonObject jsonObject, final DittoHeaders dittoHeaders)
focal_class.full_signature: public static RetrieveThings fromJson(final JsonObject jsonObject, final DittoHeaders dittoHeaders)
focal_class.identifier: fromJson
focal_class.modifiers: public static
focal_class.parameters: (final JsonObject jsonObject, final DittoHeaders dittoHeaders)
focal_class.return: RetrieveThings
focal_class.signature: RetrieveThings fromJson(final JsonObject jsonObject, final DittoHeaders dittoHeaders)
focal_class.class_method_signature: RetrieveThings.getThingIds()
focal_class.full_signature: @Deprecated public List<String> getThingIds()
focal_class.identifier: getThingIds
focal_class.modifiers: @Deprecated public
focal_class.parameters: ()
focal_class.return: List<String>
focal_class.signature: List<String> getThingIds()
focal_class.class_method_signature: RetrieveThings.getThingEntityIds()
focal_class.full_signature: public List<ThingId> getThingEntityIds()
focal_class.identifier: getThingEntityIds
focal_class.modifiers: public
focal_class.parameters: ()
focal_class.return: List<ThingId>
focal_class.signature: List<ThingId> getThingEntityIds()
focal_class.class_method_signature: RetrieveThings.getNamespace()
focal_class.full_signature: @Override public Optional<String> getNamespace()
focal_class.identifier: getNamespace
focal_class.modifiers: @Override public
focal_class.parameters: ()
focal_class.return: Optional<String>
focal_class.signature: Optional<String> getNamespace()
focal_class.class_method_signature: RetrieveThings.getSelectedFields()
focal_class.full_signature: @Override public Optional<JsonFieldSelector> getSelectedFields()
focal_class.identifier: getSelectedFields
focal_class.modifiers: @Override public
focal_class.parameters: ()
focal_class.return: Optional<JsonFieldSelector>
focal_class.signature: Optional<JsonFieldSelector> getSelectedFields()
focal_class.class_method_signature: RetrieveThings.getThingEntityId()
focal_class.full_signature: @Override public ThingId getThingEntityId()
focal_class.identifier: getThingEntityId
focal_class.modifiers: @Override public
focal_class.parameters: ()
focal_class.return: ThingId
focal_class.signature: ThingId getThingEntityId()
focal_class.class_method_signature: RetrieveThings.getResourcePath()
focal_class.full_signature: @Override public JsonPointer getResourcePath()
focal_class.identifier: getResourcePath
focal_class.modifiers: @Override public
focal_class.parameters: ()
focal_class.return: JsonPointer
focal_class.signature: JsonPointer getResourcePath()
focal_class.class_method_signature: RetrieveThings.appendPayload(final JsonObjectBuilder jsonObjectBuilder, final JsonSchemaVersion schemaVersion,
              final Predicate<JsonField> thePredicate)
focal_class.full_signature: @Override protected void appendPayload(final JsonObjectBuilder jsonObjectBuilder, final JsonSchemaVersion schemaVersion,
              final Predicate<JsonField> thePredicate)
focal_class.identifier: appendPayload
focal_class.modifiers: @Override protected
focal_class.parameters: (final JsonObjectBuilder jsonObjectBuilder, final JsonSchemaVersion schemaVersion,
              final Predicate<JsonField> thePredicate)
focal_class.return: void
focal_class.signature: void appendPayload(final JsonObjectBuilder jsonObjectBuilder, final JsonSchemaVersion schemaVersion,
              final Predicate<JsonField> thePredicate)
focal_class.class_method_signature: RetrieveThings.setDittoHeaders(final DittoHeaders dittoHeaders)
focal_class.full_signature: @Override public RetrieveThings setDittoHeaders(final DittoHeaders dittoHeaders)
focal_class.identifier: setDittoHeaders
focal_class.modifiers: @Override public
focal_class.parameters: (final DittoHeaders dittoHeaders)
focal_class.return: RetrieveThings
focal_class.signature: RetrieveThings setDittoHeaders(final DittoHeaders dittoHeaders)
focal_class.class_method_signature: RetrieveThings.hashCode()
focal_class.full_signature: @Override public int hashCode()
focal_class.identifier: hashCode
focal_class.modifiers: @Override public
focal_class.parameters: ()
focal_class.return: int
focal_class.signature: int hashCode()
focal_class.class_method_signature: RetrieveThings.equals(@Nullable final Object obj)
focal_class.full_signature: @SuppressWarnings({"squid:MethodCyclomaticComplexity", "squid:S1067", "pmd:SimplifyConditional"}) @Override public boolean equals(@Nullable final Object obj)
focal_class.identifier: equals
focal_class.modifiers: @SuppressWarnings({"squid:MethodCyclomaticComplexity", "squid:S1067", "pmd:SimplifyConditional"}) @Override public
focal_class.parameters: (@Nullable final Object obj)
focal_class.return: boolean
focal_class.signature: boolean equals(@Nullable final Object obj)
focal_class.class_method_signature: RetrieveThings.canEqual(@Nullable final Object other)
focal_class.full_signature: @Override protected boolean canEqual(@Nullable final Object other)
focal_class.identifier: canEqual
focal_class.modifiers: @Override protected
focal_class.parameters: (@Nullable final Object other)
focal_class.return: boolean
focal_class.signature: boolean canEqual(@Nullable final Object other)
focal_class.class_method_signature: RetrieveThings.toString()
focal_class.full_signature: @Override public String toString()
focal_class.identifier: toString
focal_class.modifiers: @Override public
focal_class.parameters: ()
focal_class.return: String
focal_class.signature: String toString()
focal_class.superclass: extends AbstractCommand<RetrieveThings>
focal_method.body: @Deprecated
      public static Builder getBuilder(final String... thingIds) {
          final List<ThingId> thingIdList = Arrays.stream(checkNotNull(thingIds, "thing ids"))
                  .map(ThingId::of)
                  .collect(Collectors.toList());
          return new Builder(thingIdList);
      }
focal_method.class_method_signature: RetrieveThings.getBuilder(final String... thingIds)
focal_method.full_signature: @Deprecated public static Builder getBuilder(final String... thingIds)
focal_method.identifier: getBuilder
focal_method.invocations: collect map stream checkNotNull toList
focal_method.modifiers: @Deprecated public static
focal_method.parameters: (final String... thingIds)
focal_method.return: Builder
focal_method.signature: Builder getBuilder(final String... thingIds)