Separate lazy-versioned NormalizedNodeDataInput
[controller.git] / opendaylight / md-sal / sal-clustering-commons / src / main / java / org / opendaylight / controller / cluster / datastore / node / utils / stream / NormalizedNodeInputOutput.java
1 /*
2  * Copyright (c) 2015 Cisco Systems, Inc. and others.  All rights reserved.
3  *
4  * This program and the accompanying materials are made available under the
5  * terms of the Eclipse Public License v1.0 which accompanies this distribution,
6  * and is available at http://www.eclipse.org/legal/epl-v10.html
7  */
8 package org.opendaylight.controller.cluster.datastore.node.utils.stream;
9
10 import com.google.common.annotations.Beta;
11 import java.io.DataInput;
12 import java.io.DataOutput;
13 import java.io.IOException;
14 import org.eclipse.jdt.annotation.NonNull;
15
16 @Beta
17 public final class NormalizedNodeInputOutput {
18     private NormalizedNodeInputOutput() {
19         throw new UnsupportedOperationException();
20     }
21
22     /**
23      * Creates a new {@link NormalizedNodeDataInput} instance that reads from the given input. This method first reads
24      * and validates that the input contains a valid NormalizedNode stream.
25      *
26      * @param input the DataInput to read from
27      * @return a new {@link NormalizedNodeDataInput} instance
28      * @throws IOException if an error occurs reading from the input
29      */
30     public static NormalizedNodeDataInput newDataInput(final @NonNull DataInput input) throws IOException {
31         return new VersionedNormalizedNodeDataInput(input).delegate();
32     }
33
34     /**
35      * Creates a new {@link NormalizedNodeDataInput} instance that reads from the given input. This method does not
36      * perform any initial validation of the input stream.
37      *
38      * @param input the DataInput to read from
39      * @return a new {@link NormalizedNodeDataInput} instance
40      */
41     public static NormalizedNodeDataInput newDataInputWithoutValidation(final @NonNull DataInput input) {
42         return new VersionedNormalizedNodeDataInput(input);
43     }
44
45     /**
46      * Creates a new {@link NormalizedNodeDataOutput} instance that writes to the given output.
47      *
48      * @param output the DataOutput to write to
49      * @return a new {@link NormalizedNodeDataOutput} instance
50      */
51     public static NormalizedNodeDataOutput newDataOutput(final @NonNull DataOutput output) {
52         return new NormalizedNodeOutputStreamWriter(output);
53     }
54 }

©2013 OpenDaylight, A Linux Foundation Collaborative Project. All Rights Reserved.
OpenDaylight is a registered trademark of The OpenDaylight Project, Inc.
Linux Foundation and OpenDaylight are registered trademarks of the Linux Foundation.
Linux is a registered trademark of Linus Torvalds.