X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?a=blobdiff_plain;f=opendaylight%2Fmd-sal%2Fsal-clustering-commons%2Fsrc%2Fmain%2Fjava%2Forg%2Fopendaylight%2Fcontroller%2Fcluster%2Fdatastore%2Fnode%2Futils%2Fstream%2FNormalizedNodeInputOutput.java;h=bcb4cbf16f569c3584f10e28d04a6b88059162c1;hb=11666b718f70c7846cd64ebf949a4e91d84e0e65;hp=cb84ef881095725fa8a7ec0d9e3f7f79380c21a4;hpb=87c8362c7501408b281f5ddc9b78ed7440280fa1;p=controller.git diff --git a/opendaylight/md-sal/sal-clustering-commons/src/main/java/org/opendaylight/controller/cluster/datastore/node/utils/stream/NormalizedNodeInputOutput.java b/opendaylight/md-sal/sal-clustering-commons/src/main/java/org/opendaylight/controller/cluster/datastore/node/utils/stream/NormalizedNodeInputOutput.java index cb84ef8810..bcb4cbf16f 100644 --- a/opendaylight/md-sal/sal-clustering-commons/src/main/java/org/opendaylight/controller/cluster/datastore/node/utils/stream/NormalizedNodeInputOutput.java +++ b/opendaylight/md-sal/sal-clustering-commons/src/main/java/org/opendaylight/controller/cluster/datastore/node/utils/stream/NormalizedNodeInputOutput.java @@ -7,21 +7,69 @@ */ package org.opendaylight.controller.cluster.datastore.node.utils.stream; +import com.google.common.annotations.Beta; import java.io.DataInput; import java.io.DataOutput; import java.io.IOException; -import javax.annotation.Nonnull; +import org.eclipse.jdt.annotation.NonNull; +@Beta public final class NormalizedNodeInputOutput { private NormalizedNodeInputOutput() { throw new UnsupportedOperationException(); } - public static NormalizedNodeDataInput newDataInput(@Nonnull final DataInput input) throws IOException { - return new NormalizedNodeInputStreamReader(input); + /** + * Creates a new {@link NormalizedNodeDataInput} instance that reads from the given input. This method first reads + * and validates that the input contains a valid NormalizedNode stream. + * + * @param input the DataInput to read from + * @return a new {@link NormalizedNodeDataInput} instance + * @throws IOException if an error occurs reading from the input + */ + public static NormalizedNodeDataInput newDataInput(final @NonNull DataInput input) throws IOException { + return new VersionedNormalizedNodeDataInput(input).delegate(); } - public static NormalizedNodeDataOutput newDataOutput(@Nonnull final DataOutput output) throws IOException { + /** + * Creates a new {@link NormalizedNodeDataInput} instance that reads from the given input. This method does not + * perform any initial validation of the input stream. + * + * @param input the DataInput to read from + * @return a new {@link NormalizedNodeDataInput} instance + */ + public static NormalizedNodeDataInput newDataInputWithoutValidation(final @NonNull DataInput input) { + return new VersionedNormalizedNodeDataInput(input); + } + + /** + * Creates a new {@link NormalizedNodeDataOutput} instance that writes to the given output and latest current + * stream version. + * + * @param output the DataOutput to write to + * @return a new {@link NormalizedNodeDataOutput} instance + */ + public static NormalizedNodeDataOutput newDataOutput(final @NonNull DataOutput output) { return new NormalizedNodeOutputStreamWriter(output); } + + /** + * Creates a new {@link NormalizedNodeDataOutput} instance that writes to the given output. + * + * @param output the DataOutput to write to + * @param version Streaming version to use + * @return a new {@link NormalizedNodeDataOutput} instance + */ + public static NormalizedNodeDataOutput newDataOutput(final @NonNull DataOutput output, + final @NonNull NormalizedNodeStreamVersion version) { + switch (version) { + case LITHIUM: + return new LithiumNormalizedNodeOutputStreamWriter(output); + case SODIUM: + return new SodiumNormalizedNodeOutputStreamWriter(output); + default: + throw new IllegalStateException("Unhandled version " + version); + } + } + }