You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by st...@apache.org on 2018/02/20 10:50:35 UTC
[2/3] commons-rdf git commit: equivalent WriterConfig
equivalent WriterConfig
Project: http://git-wip-us.apache.org/repos/asf/commons-rdf/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-rdf/commit/5f1c7814
Tree: http://git-wip-us.apache.org/repos/asf/commons-rdf/tree/5f1c7814
Diff: http://git-wip-us.apache.org/repos/asf/commons-rdf/diff/5f1c7814
Branch: refs/heads/fluent-parser
Commit: 5f1c781491734c4ef71bec9ad6393b50e09062b4
Parents: 6c9cc64
Author: Stian Soiland-Reyes <st...@apache.org>
Authored: Tue Feb 20 10:43:50 2018 +0000
Committer: Stian Soiland-Reyes <st...@apache.org>
Committed: Tue Feb 20 10:45:57 2018 +0000
----------------------------------------------------------------------
.../java/org/apache/commons/rdf/api/RDF.java | 17 ++
.../commons/rdf/api/fluentwriter/Async.java | 2 +-
.../commons/rdf/api/fluentwriter/Buildable.java | 49 ++++
.../rdf/api/fluentwriter/NeedSource.java | 2 +-
.../rdf/api/fluentwriter/NeedTarget.java | 2 +-
.../commons/rdf/api/fluentwriter/Sync.java | 2 +-
.../rdf/api/fluentwriter/_Buildable.java | 49 ----
.../commons/rdf/api/io/MutableWriterConfig.java | 103 ++++++++
.../commons/rdf/api/io/NullWriterConfig.java | 252 +++++++++++++++++++
.../org/apache/commons/rdf/api/io/Writer.java | 54 ++++
.../apache/commons/rdf/api/io/WriterConfig.java | 68 +++++
11 files changed, 547 insertions(+), 53 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/commons-rdf/blob/5f1c7814/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/RDF.java
----------------------------------------------------------------------
diff --git a/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/RDF.java b/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/RDF.java
index 8fab94f..46f7499 100644
--- a/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/RDF.java
+++ b/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/RDF.java
@@ -28,6 +28,7 @@ import org.apache.commons.rdf.api.fluentparser.Sync;
import org.apache.commons.rdf.api.io.Parsed;
import org.apache.commons.rdf.api.io.Parser;
import org.apache.commons.rdf.api.io.ParserBuilder;
+import org.apache.commons.rdf.api.io.Writer;
/**
* A RDF implementation.
@@ -328,4 +329,20 @@ public interface RDF {
*/
public Optional<Parser> parser(RDFSyntax syntax);
+ /**
+ * Return a writer for the given RDF syntax.
+ * <p>
+ * If the syntax is not supported/recognised by this RDF implementation,
+ * return {@link Optional#empty()}, otherwise return an {@link Optional}
+ * containing an {@link Writer} for that syntax.
+ * <p>
+ * If the provided syntax is <code>null</code>,
+ * return a generic {@link Writer} that can detect the syntax
+ * (e.g. from WriterConfig), or {@link Optional#empty()} if this feature is not supported.
+ *
+ * @param syntax RDF Syntax to write, or <code>null</code> for syntax to be configured later.
+ * @return A {@link Writer}, or {@link Optional#empty()} if the
+ * syntax is not supported.
+ */
+ public Optional<Writer> writer(RDFSyntax syntax);
}
http://git-wip-us.apache.org/repos/asf/commons-rdf/blob/5f1c7814/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/Async.java
----------------------------------------------------------------------
diff --git a/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/Async.java b/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/Async.java
index e7edcf4..99982eb 100644
--- a/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/Async.java
+++ b/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/Async.java
@@ -5,7 +5,7 @@ import java.util.concurrent.Future;
import org.apache.commons.rdf.api.io.Option;
import org.apache.commons.rdf.api.io.Written;
-public interface Async extends _Buildable {
+public interface Async extends Buildable {
Async build();
<V> Async option(Option<V> option, V value);
http://git-wip-us.apache.org/repos/asf/commons-rdf/blob/5f1c7814/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/Buildable.java
----------------------------------------------------------------------
diff --git a/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/Buildable.java b/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/Buildable.java
new file mode 100644
index 0000000..bd6aeab
--- /dev/null
+++ b/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/Buildable.java
@@ -0,0 +1,49 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF 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.
+ */
+package org.apache.commons.rdf.api.fluentwriter;
+
+import org.apache.commons.rdf.api.io.Option;
+import org.apache.commons.rdf.api.io.Option.RequiredOption;
+
+public interface Buildable {
+ /**
+ * Return an immutable builder at the current state. The returned builder
+ * can be re-used multiple times in a thread-safe way.
+ *
+ * @return An immutable builder
+ */
+ Buildable build();
+
+ /**
+ * Return a builder with the given option set.
+ * <p>
+ * Note that implementations of {@link Writer} may support different
+ * vendor-specific {@link Option} types, and are free to ignore the set
+ * option (unless it is a {@link RequiredOption}).
+ * <p>
+ * It is undefined if setting multiple values for the same (equal) option
+ * are accumulative or overriding.
+ *
+ * @param <V> The type of the {@link Option} value
+ * @param option Option to set
+ * @param value Value to set for option
+ * @return A builder with the given option set
+ */
+ <V> Buildable option(Option<V> option, V value);
+
+}
http://git-wip-us.apache.org/repos/asf/commons-rdf/blob/5f1c7814/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/NeedSource.java
----------------------------------------------------------------------
diff --git a/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/NeedSource.java b/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/NeedSource.java
index 3070427..007777e 100644
--- a/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/NeedSource.java
+++ b/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/NeedSource.java
@@ -8,7 +8,7 @@ import org.apache.commons.rdf.api.TripleLike;
import org.apache.commons.rdf.api.io.Option;
import org.apache.commons.rdf.api.io.WriterSource;
-public interface NeedSource extends _Buildable {
+public interface NeedSource extends Buildable {
NeedSource build();
<V> NeedSource option(Option<V> option, V value);
http://git-wip-us.apache.org/repos/asf/commons-rdf/blob/5f1c7814/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/NeedTarget.java
----------------------------------------------------------------------
diff --git a/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/NeedTarget.java b/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/NeedTarget.java
index 2148b54..2f245d8 100644
--- a/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/NeedTarget.java
+++ b/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/NeedTarget.java
@@ -23,7 +23,7 @@ import java.nio.file.Path;
import org.apache.commons.rdf.api.io.Option;
import org.apache.commons.rdf.api.io.WriterTarget;
-public interface NeedTarget extends _Buildable {
+public interface NeedTarget extends Buildable {
@Override
NeedTarget build();
<V> NeedTarget option(Option<V> option, V value);
http://git-wip-us.apache.org/repos/asf/commons-rdf/blob/5f1c7814/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/Sync.java
----------------------------------------------------------------------
diff --git a/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/Sync.java b/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/Sync.java
index f6d8afc..af2ba05 100644
--- a/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/Sync.java
+++ b/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/Sync.java
@@ -5,7 +5,7 @@ import java.util.concurrent.ExecutorService;
import org.apache.commons.rdf.api.io.Option;
import org.apache.commons.rdf.api.io.Written;
-public interface Sync extends _Buildable {
+public interface Sync extends Buildable {
Sync build();
<V> Sync option(Option<V> option, V value);
http://git-wip-us.apache.org/repos/asf/commons-rdf/blob/5f1c7814/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/_Buildable.java
----------------------------------------------------------------------
diff --git a/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/_Buildable.java b/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/_Buildable.java
deleted file mode 100644
index 95c4c7b..0000000
--- a/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/fluentwriter/_Buildable.java
+++ /dev/null
@@ -1,49 +0,0 @@
-/**
- * Licensed to the Apache Software Foundation (ASF) under one
- * or more contributor license agreements. See the NOTICE file
- * distributed with this work for additional information
- * regarding copyright ownership. The ASF 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.
- */
-package org.apache.commons.rdf.api.fluentwriter;
-
-import org.apache.commons.rdf.api.io.Option;
-import org.apache.commons.rdf.api.io.Option.RequiredOption;
-
-interface _Buildable {
- /**
- * Return an immutable builder at the current state. The returned builder
- * can be re-used multiple times in a thread-safe way.
- *
- * @return An immutable builder
- */
- _Buildable build();
-
- /**
- * Return a builder with the given option set.
- * <p>
- * Note that implementations of {@link Writer} may support different
- * vendor-specific {@link Option} types, and are free to ignore the set
- * option (unless it is a {@link RequiredOption}).
- * <p>
- * It is undefined if setting multiple values for the same (equal) option
- * are accumulative or overriding.
- *
- * @param <V> The type of the {@link Option} value
- * @param option Option to set
- * @param value Value to set for option
- * @return A builder with the given option set
- */
- <V> _Buildable option(Option<V> option, V value);
-
-}
http://git-wip-us.apache.org/repos/asf/commons-rdf/blob/5f1c7814/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/io/MutableWriterConfig.java
----------------------------------------------------------------------
diff --git a/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/io/MutableWriterConfig.java b/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/io/MutableWriterConfig.java
new file mode 100644
index 0000000..96df0ee
--- /dev/null
+++ b/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/io/MutableWriterConfig.java
@@ -0,0 +1,103 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF 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.
+ */
+package org.apache.commons.rdf.api.io;
+
+import java.io.Serializable;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Optional;
+
+import org.apache.commons.rdf.api.RDF;
+import org.apache.commons.rdf.api.RDFSyntax;
+
+final class MutableWriterConfig implements Cloneable, Serializable, WriterConfig {
+ private static final long serialVersionUID = 1L;
+ private RDF rdf = null;
+ private RDFSyntax syntax = null;
+ private WriterSource source = null;
+ private WriterTarget target = null;
+ @SuppressWarnings("rawtypes")
+ private final Map<Option, Object> options = new HashMap<>();
+
+ public MutableWriterConfig() {
+ }
+
+ public MutableWriterConfig(WriterConfig old) {
+ rdf = old.rdf().orElse(null);
+ syntax = old.syntax().orElse(null);
+ source = old.source().orElse(null);
+ target = old.target().orElse(null);
+ options.putAll(old.options());
+ }
+
+ @Override
+ protected Object clone() {
+ return new MutableWriterConfig(this);
+ }
+
+ @Override
+ public Optional<WriterSource> source() {
+ return Optional.ofNullable(source);
+ }
+
+ @Override
+ public Optional<WriterTarget> target() {
+ return Optional.ofNullable(target);
+ }
+
+ @Override
+ public Optional<RDFSyntax> syntax() {
+ return Optional.ofNullable(syntax);
+ }
+
+ @Override
+ public Optional<RDF> rdf() {
+ return Optional.ofNullable(rdf);
+ }
+
+ @SuppressWarnings("rawtypes")
+ @Override
+ public Map<Option, Object> options() {
+ return options;
+ }
+
+ public WriterConfig withSyntax(RDFSyntax syntax) {
+ this.syntax = syntax;
+ return this;
+ }
+
+ public WriterConfig withSource(WriterSource source) {
+ this.source = source;
+ return this;
+ }
+
+ public WriterConfig withTarget(WriterTarget target) {
+ this.target = target;
+ return this;
+ }
+
+ public WriterConfig withRDF(RDF rdf) {
+ this.rdf = rdf;
+ return this;
+ }
+
+ public <V> WriterConfig withOption(Option<V> o, V v) {
+ this.options.put(o, v);
+ return this;
+ }
+
+}
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/commons-rdf/blob/5f1c7814/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/io/NullWriterConfig.java
----------------------------------------------------------------------
diff --git a/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/io/NullWriterConfig.java b/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/io/NullWriterConfig.java
new file mode 100644
index 0000000..e26cfaf
--- /dev/null
+++ b/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/io/NullWriterConfig.java
@@ -0,0 +1,252 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF 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.
+ */
+package org.apache.commons.rdf.api.io;
+
+import java.io.Serializable;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Optional;
+import java.util.concurrent.ExecutorService;
+
+import org.apache.commons.rdf.api.IRI;
+import org.apache.commons.rdf.api.RDF;
+import org.apache.commons.rdf.api.RDFSyntax;
+import org.apache.commons.rdf.api.io.WriterConfig.ImmutableWriterConfig;
+
+class NullWriterConfig implements ImmutableWriterConfig, Serializable {
+
+ private static final long serialVersionUID = 1L;
+
+ @Override
+ public Optional<WriterSource> source() {
+ return Optional.empty();
+ }
+
+ @Override
+ public Optional<WriterTarget> target() {
+ return Optional.empty();
+ }
+
+ @Override
+ public Optional<RDFSyntax> syntax() {
+ return Optional.empty();
+ }
+
+ @Override
+ public Optional<RDF> rdf() {
+ return Optional.empty();
+ }
+
+ @SuppressWarnings("rawtypes")
+ @Override
+ public Map<Option, Object> options() {
+ return Collections.emptyMap();
+ }
+
+ @Override
+ public WriterConfig withSyntax(RDFSyntax syntax) {
+ return new WithSyntax(this, syntax);
+ }
+
+ @Override
+ public WriterConfig withSource(WriterSource source) {
+ return new WithSource(this, source);
+ }
+
+ @Override
+ public WriterConfig withTarget(WriterTarget target) {
+ return new WithTarget(this, target);
+ }
+
+ @Override
+ public WriterConfig withRDF(RDF rdf) {
+ return new WithRDF(this, rdf);
+ }
+
+ @Override
+ public <V> WriterConfig withOption(Option<V> o, V v) {
+ return new WithOption(this, o, v);
+ }
+
+ static class WithParent extends NullWriterConfig implements ImmutableWriterConfig {
+ private final ImmutableWriterConfig parent;
+
+ WithParent(ImmutableWriterConfig parent) {
+ this.parent = parent;
+ }
+
+ @Override
+ public Optional<WriterSource> source() {
+ return parent.source();
+ }
+
+ @Override
+ public Optional<WriterTarget> target() {
+ return parent.target();
+ }
+
+ @Override
+ public Optional<RDFSyntax> syntax() {
+ return parent.syntax();
+ }
+
+ @Override
+ public Optional<RDF> rdf() {
+ return parent.rdf();
+ }
+
+ @Override
+ public Map<Option, Object> options() {
+ return parent.options();
+ }
+ }
+
+ static final class WithSyntax extends WithParent implements WriterConfig {
+ private final RDFSyntax syntax;
+
+ public WithSyntax(ImmutableWriterConfig parent, RDFSyntax syntax) {
+ super(parent);
+ this.syntax = syntax;
+ }
+
+ @Override
+ public Optional<RDFSyntax> syntax() {
+ return Optional.ofNullable(syntax);
+ }
+ }
+
+ static final class WithSource extends WithParent implements WriterConfig {
+ private final WriterSource source;
+
+ public WithSource(ImmutableWriterConfig parent, WriterSource source) {
+ super(parent);
+ this.source = source;
+ }
+
+ @Override
+ public Optional<WriterSource> source() {
+ return Optional.ofNullable(source);
+ }
+ }
+
+ static class WithTarget extends WithParent implements WriterConfig {
+ private final WriterTarget target;
+
+ public WithTarget(ImmutableWriterConfig parent, WriterTarget target) {
+ super(parent);
+ this.target = target;
+ }
+
+ @Override
+ public Optional<WriterTarget> target() {
+ return Optional.ofNullable(target);
+ }
+ }
+
+ static class WithRDF extends WithParent implements WriterConfig {
+ private final RDF rdf;
+
+ public WithRDF(ImmutableWriterConfig parent, RDF rdf) {
+ super(parent);
+ this.rdf = rdf;
+ }
+ @Override
+ public Optional<RDF> rdf() {
+ return Optional.ofNullable(rdf);
+ }
+
+ }
+
+ static class WithOption extends WithParent implements WriterConfig {
+ private Option o;
+ private Object v;
+ public <V> WithOption(ImmutableWriterConfig parent, Option<V> o, V v) {
+ super(parent);
+ this.o = o;
+ this.v = v;
+ }
+ @Override
+ public Map<Option, Object> options() {
+ // Add to parent options
+ Map<Option, Object> options = super.options();
+ if (v == null) {
+ options.remove(o);
+ } else {
+ options.put(o, v);
+ }
+ return options;
+ }
+ }
+
+ @SuppressWarnings("rawtypes")
+ final static class SnapshotWriterConfig extends NullWriterConfig {
+ private static final long serialVersionUID = 1L;
+ private final RDF rdf;
+ private final RDFSyntax syntax;
+ private final WriterSource source;
+ private final WriterTarget target;
+ private final Map<Option, Object> options;
+
+ SnapshotWriterConfig(WriterConfig old) {
+ this(
+ old.rdf().orElse(null),
+ old.syntax().orElse(null),
+ old.source().orElse(null),
+ old.target().orElse(null),
+ old.options(),
+ null);
+ }
+
+ SnapshotWriterConfig(RDF rdf, RDFSyntax syntax, WriterSource source, WriterTarget target, Map<Option, Object> options,
+ ExecutorService executor) {
+ this.rdf = rdf;
+ this.syntax = syntax;
+ this.source = source;
+ this.target = target;
+ // We'll make a copy
+ this.options = Collections.unmodifiableMap(new HashMap<Option, Object>(options));
+ }
+
+ @Override
+ public Optional<WriterSource> source() {
+ return Optional.ofNullable(source);
+ }
+
+ @Override
+ public Optional<WriterTarget> target() {
+ return Optional.ofNullable(target);
+ }
+
+ @Override
+ public Optional<RDFSyntax> syntax() {
+ return Optional.ofNullable(syntax);
+ }
+
+ @Override
+ public Optional<RDF> rdf() {
+ return Optional.ofNullable(rdf);
+ }
+
+ @Override
+ public Map<Option, Object> options() {
+ // return a mutable copy so our children can build on it
+ return new HashMap<Option,Object>(options);
+ }
+ }
+
+}
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/commons-rdf/blob/5f1c7814/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/io/Writer.java
----------------------------------------------------------------------
diff --git a/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/io/Writer.java b/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/io/Writer.java
new file mode 100644
index 0000000..5267e97
--- /dev/null
+++ b/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/io/Writer.java
@@ -0,0 +1,54 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF 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.
+ */
+package org.apache.commons.rdf.api.io;
+
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+import java.util.concurrent.Future;
+
+public interface Writer {
+
+ @SuppressWarnings("rawtypes")
+ Written write(WriterConfig config);
+
+// @SuppressWarnings("rawtypes")
+// default Future<Parsed> writeAsync(ParserConfig config) {
+// return new DefaultAsyncWriter(this, config).submit();
+// }
+
+// class DefaultAsyncParser {
+// private static final ThreadGroup THEAD_GROUP = new ThreadGroup("Commons RDF async writer");
+// private static final ExecutorService DEFAULT_EXECUTOR = Executors
+// .newCachedThreadPool(r -> new Thread(THEAD_GROUP, r));
+//
+// private final Writer syncWriter;
+// private final WriterConfig config;
+//
+// DefaultAsyncParser(Writer writer, WriterConfig config) {
+// this.syncWriter = writer;
+// this.config = config.asImmutableConfig();
+// }
+//
+// Written write() {
+// return syncWriter.write(config);
+// }
+//
+// Future<Parsed> submit() {
+// return DEFAULT_EXECUTOR.submit(this::write);
+// }
+// }
+}
http://git-wip-us.apache.org/repos/asf/commons-rdf/blob/5f1c7814/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/io/WriterConfig.java
----------------------------------------------------------------------
diff --git a/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/io/WriterConfig.java b/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/io/WriterConfig.java
new file mode 100644
index 0000000..bbe781f
--- /dev/null
+++ b/commons-rdf-api/src/main/java/org/apache/commons/rdf/api/io/WriterConfig.java
@@ -0,0 +1,68 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF 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.
+ */
+package org.apache.commons.rdf.api.io;
+
+import java.io.Serializable;
+import java.util.Map;
+import java.util.Optional;
+
+import org.apache.commons.rdf.api.RDF;
+import org.apache.commons.rdf.api.RDFSyntax;
+import org.apache.commons.rdf.api.io.NullWriterConfig.SnapshotWriterConfig;
+
+@SuppressWarnings("rawtypes")
+public interface WriterConfig {
+ Optional<WriterSource> source();
+ Optional<WriterTarget> target();
+ Optional<RDFSyntax> syntax();
+ Optional<RDF> rdf();
+ Map<Option, Object> options();
+
+ WriterConfig withSyntax(RDFSyntax syntax);
+ WriterConfig withSource(WriterSource source);
+ WriterConfig withTarget(WriterTarget target);
+ WriterConfig withRDF(RDF rdf);
+
+ <V> WriterConfig withOption(Option<V> o, V v);
+
+ static WriterConfig immutable() {
+ return new NullWriterConfig();
+ }
+
+ static WriterConfig mutable() {
+ return new MutableWriterConfig();
+ }
+
+ default WriterConfig asMutableConfig() {
+ if (this instanceof MutableWriterConfig) {
+ return this;
+ } else {
+ return new MutableWriterConfig(this);
+ }
+ }
+
+ default ImmutableWriterConfig asImmutableConfig() {
+ if (this instanceof ImmutableWriterConfig) {
+ return (ImmutableWriterConfig) this;
+ } else {
+ return new SnapshotWriterConfig(this);
+ }
+ }
+
+ interface ImmutableWriterConfig extends WriterConfig, Serializable {}
+
+}