/* * SPDX-License-Identifier: Apache-2.0 * * The OpenSearch Contributors require contributions made to * this file be licensed under the Apache-2.0 license or a * compatible open source license. */ /* * Licensed to Elasticsearch under one or more contributor * license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright * ownership. Elasticsearch licenses this file to you under * the Apache License, Version 2.0 (the "License"); you may * not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, * software distributed under the License is distributed on an * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY * KIND, either express or implied. See the License for the * specific language governing permissions and limitations * under the License. */ /* * Modifications Copyright OpenSearch Contributors. See * GitHub history for details. */ package org.opensearch.tasks; import org.opensearch.common.io.stream.BytesStreamOutput; import org.opensearch.core.common.io.stream.NamedWriteableAwareStreamInput; import org.opensearch.core.common.io.stream.NamedWriteableRegistry; import org.opensearch.core.common.io.stream.StreamInput; import org.opensearch.core.xcontent.MediaTypeRegistry; import org.opensearch.core.xcontent.ToXContent; import org.opensearch.core.xcontent.XContentBuilder; import org.opensearch.core.xcontent.XContentParser; import org.opensearch.common.xcontent.XContentType; import org.opensearch.test.OpenSearchTestCase; import java.io.IOException; import java.util.Collections; import java.util.Map; import java.util.TreeMap; import static org.opensearch.tasks.TaskInfoTests.randomTaskInfo; /** * Round trip tests for {@link TaskResult} and those classes that it includes like {@link TaskInfo} and {@link RawTaskStatus}. */ public class TaskResultTests extends OpenSearchTestCase { public void testBinaryRoundTrip() throws IOException { NamedWriteableRegistry registry = new NamedWriteableRegistry( Collections.singletonList(new NamedWriteableRegistry.Entry(Task.Status.class, RawTaskStatus.NAME, RawTaskStatus::new)) ); TaskResult result = randomTaskResult(); TaskResult read; try (BytesStreamOutput out = new BytesStreamOutput()) { result.writeTo(out); try (StreamInput in = new NamedWriteableAwareStreamInput(out.bytes().streamInput(), registry)) { read = new TaskResult(in); } } catch (IOException e) { throw new IOException("Error processing [" + result + "]", e); } assertEquals(result, read); } public void testXContentRoundTrip() throws IOException { /* * Note that this round trip isn't 100% perfect - status will always be read as RawTaskStatus. Since this test uses RawTaskStatus * as the status we randomly generate then we can assert the round trip with .equals. */ TaskResult result = randomTaskResult(); TaskResult read; try (XContentBuilder builder = XContentBuilder.builder(randomFrom(XContentType.values()).xContent())) { result.toXContent(builder, ToXContent.EMPTY_PARAMS); try (XContentBuilder shuffled = shuffleXContent(builder); XContentParser parser = createParser(shuffled)) { read = TaskResult.PARSER.apply(parser, null); } } catch (IOException e) { throw new IOException("Error processing [" + result + "]", e); } assertEquals(result, read); } public void testTaskInfoIsForwardCompatible() throws IOException { TaskInfo taskInfo = randomTaskInfo(); TaskInfo read; try (XContentBuilder builder = XContentBuilder.builder(randomFrom(XContentType.values()).xContent())) { builder.startObject(); taskInfo.toXContent(builder, ToXContent.EMPTY_PARAMS); builder.endObject(); try (XContentBuilder withExtraFields = addRandomUnknownFields(builder)) { try (XContentBuilder shuffled = shuffleXContent(withExtraFields)) { try (XContentParser parser = createParser(shuffled)) { read = TaskInfo.PARSER.apply(parser, null); } } } } catch (IOException e) { throw new IOException("Error processing [" + taskInfo + "]", e); } assertEquals(taskInfo, read); } private XContentBuilder addRandomUnknownFields(XContentBuilder builder) throws IOException { try (XContentParser parser = createParser(builder)) { Map map = parser.mapOrdered(); int numberOfNewFields = randomIntBetween(2, 10); for (int i = 0; i < numberOfNewFields; i++) { if (randomBoolean()) { map.put("unknown_field" + i, randomAlphaOfLength(20)); } else { map.put("unknown_field" + i, Collections.singletonMap("inner", randomAlphaOfLength(20))); } } XContentBuilder xContentBuilder = MediaTypeRegistry.contentBuilder(parser.contentType()); return xContentBuilder.map(map); } } private static TaskResult randomTaskResult() throws IOException { switch (between(0, 2)) { case 0: return new TaskResult(randomBoolean(), randomTaskInfo()); case 1: return new TaskResult(randomTaskInfo(), new RuntimeException("error")); case 2: return new TaskResult(randomTaskInfo(), randomTaskResponse()); default: throw new UnsupportedOperationException("Unsupported random TaskResult constructor"); } } private static ToXContent randomTaskResponse() { Map result = new TreeMap<>(); int fields = between(0, 10); for (int f = 0; f < fields; f++) { result.put(randomAlphaOfLength(5), randomAlphaOfLength(5)); } return new ToXContent() { @Override public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException { // Responses in Elasticsearch never output a leading startObject. There isn't really a good reason, they just don't. for (Map.Entry entry : result.entrySet()) { builder.field(entry.getKey(), entry.getValue()); } return builder; } }; } }