You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by da...@apache.org on 2023/06/28 07:35:21 UTC
[camel] branch main updated: CAMEL-19512: Add javadoc to StreamCache useage
This is an automated email from the ASF dual-hosted git repository.
davsclaus pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git
The following commit(s) were added to refs/heads/main by this push:
new 0baa7edd311 CAMEL-19512: Add javadoc to StreamCache useage
0baa7edd311 is described below
commit 0baa7edd31197b3d549facc3281f1095ecb1e469
Author: Claus Ibsen <cl...@gmail.com>
AuthorDate: Wed Jun 28 09:35:04 2023 +0200
CAMEL-19512: Add javadoc to StreamCache useage
---
.../apache/camel/component/cxf/converter/CachedCxfPayload.java | 8 ++++++++
.../camel/component/netty/http/NettyChannelBufferStreamCache.java | 5 +++++
core/camel-api/src/main/java/org/apache/camel/StreamCache.java | 5 +++++
.../apache/camel/converter/stream/ByteArrayInputStreamCache.java | 7 ++++++-
.../org/apache/camel/converter/stream/FileInputStreamCache.java | 7 ++++++-
.../java/org/apache/camel/converter/stream/InputStreamCache.java | 2 ++
.../main/java/org/apache/camel/converter/stream/ReaderCache.java | 7 ++++++-
.../src/main/java/org/apache/camel/util/xml/SourceCache.java | 7 ++++++-
.../main/java/org/apache/camel/util/xml/StreamSourceCache.java | 7 ++++++-
9 files changed, 50 insertions(+), 5 deletions(-)
diff --git a/components/camel-cxf/camel-cxf-common/src/main/java/org/apache/camel/component/cxf/converter/CachedCxfPayload.java b/components/camel-cxf/camel-cxf-common/src/main/java/org/apache/camel/component/cxf/converter/CachedCxfPayload.java
index 7b5b631a9d2..9fc2e8fc4a4 100644
--- a/components/camel-cxf/camel-cxf-common/src/main/java/org/apache/camel/component/cxf/converter/CachedCxfPayload.java
+++ b/components/camel-cxf/camel-cxf-common/src/main/java/org/apache/camel/component/cxf/converter/CachedCxfPayload.java
@@ -46,6 +46,14 @@ import org.apache.cxf.staxutils.StaxUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
+/**
+ * {@link org.apache.camel.StreamCache} implementation for CXF payload.
+ * <p/>
+ * <b>Important:</b>
+ * All the classes from the Camel release that implements {@link StreamCache} is NOT intended for end users
+ * to create as instances, but they are part of
+ * Camels <a href="https://camel.apache.org/manual/stream-caching.html">stream-caching</a> functionality.
+ */
public class CachedCxfPayload<T> extends CxfPayload<T> implements StreamCache {
private static final Logger LOG = LoggerFactory.getLogger(CachedCxfPayload.class);
private static String defaultCharset = ObjectHelper.getSystemProperty("org.apache.camel.default.charset", "UTF-8");
diff --git a/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/NettyChannelBufferStreamCache.java b/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/NettyChannelBufferStreamCache.java
index bf71c9346ac..33b814b6f79 100644
--- a/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/NettyChannelBufferStreamCache.java
+++ b/components/camel-netty-http/src/main/java/org/apache/camel/component/netty/http/NettyChannelBufferStreamCache.java
@@ -29,6 +29,11 @@ import org.apache.camel.util.IOHelper;
* A {@link ByteBuf} which is exposed as an {@link InputStream} which makes it very easy to use by Camel and other Camel
* components. Also supported is {@link StreamCache} which allows the data to be re-read for example when doing content
* based routing with XPath.
+ * <p/>
+ * <b>Important:</b>
+ * All the classes from the Camel release that implements {@link StreamCache} is NOT intended for end users
+ * to create as instances, but they are part of
+ * Camels <a href="https://camel.apache.org/manual/stream-caching.html">stream-caching</a> functionality.
*/
public final class NettyChannelBufferStreamCache extends InputStream implements StreamCache {
diff --git a/core/camel-api/src/main/java/org/apache/camel/StreamCache.java b/core/camel-api/src/main/java/org/apache/camel/StreamCache.java
index 515ef286df8..429dc4c4d73 100644
--- a/core/camel-api/src/main/java/org/apache/camel/StreamCache.java
+++ b/core/camel-api/src/main/java/org/apache/camel/StreamCache.java
@@ -30,6 +30,11 @@ import java.io.OutputStream;
* <p/>
* It is recommended in the {@link #copy(Exchange)} method to let the copied stream start from the start. If the
* implementation does not support copy, then return <tt>null</tt>.
+ * <p/>
+ * <b>Important:</b>
+ * All the classes from the Camel release that implements {@link StreamCache} is NOT intended for end users
+ * to create as instances, but they are part of
+ * Camels <a href="https://camel.apache.org/manual/stream-caching.html">stream-caching</a> functionality.
*/
public interface StreamCache {
diff --git a/core/camel-support/src/main/java/org/apache/camel/converter/stream/ByteArrayInputStreamCache.java b/core/camel-support/src/main/java/org/apache/camel/converter/stream/ByteArrayInputStreamCache.java
index dac938d5238..2e837119402 100644
--- a/core/camel-support/src/main/java/org/apache/camel/converter/stream/ByteArrayInputStreamCache.java
+++ b/core/camel-support/src/main/java/org/apache/camel/converter/stream/ByteArrayInputStreamCache.java
@@ -27,7 +27,12 @@ import org.apache.camel.StreamCache;
import org.apache.camel.util.IOHelper;
/**
- * A {@link StreamCache} for {@link java.io.ByteArrayInputStream}
+ * A {@link StreamCache} for {@link java.io.ByteArrayInputStream}.
+ * <p/>
+ * <b>Important:</b>
+ * All the classes from the Camel release that implements {@link StreamCache} is NOT intended for end users
+ * to create as instances, but they are part of
+ * Camels <a href="https://camel.apache.org/manual/stream-caching.html">stream-caching</a> functionality.
*/
public class ByteArrayInputStreamCache extends FilterInputStream implements StreamCache {
diff --git a/core/camel-support/src/main/java/org/apache/camel/converter/stream/FileInputStreamCache.java b/core/camel-support/src/main/java/org/apache/camel/converter/stream/FileInputStreamCache.java
index dab0c36ad1c..c6a771170a0 100644
--- a/core/camel-support/src/main/java/org/apache/camel/converter/stream/FileInputStreamCache.java
+++ b/core/camel-support/src/main/java/org/apache/camel/converter/stream/FileInputStreamCache.java
@@ -47,7 +47,12 @@ import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
- * A {@link StreamCache} for {@link File}s
+ * A {@link StreamCache} for {@link File}s.
+ * <p/>
+ * <b>Important:</b>
+ * All the classes from the Camel release that implements {@link StreamCache} is NOT intended for end users
+ * to create as instances, but they are part of
+ * Camels <a href="https://camel.apache.org/manual/stream-caching.html">stream-caching</a> functionality.
*/
public final class FileInputStreamCache extends InputStream implements StreamCache {
private InputStream stream;
diff --git a/core/camel-support/src/main/java/org/apache/camel/converter/stream/InputStreamCache.java b/core/camel-support/src/main/java/org/apache/camel/converter/stream/InputStreamCache.java
index 5c7cf3c54ab..f839ee480f2 100644
--- a/core/camel-support/src/main/java/org/apache/camel/converter/stream/InputStreamCache.java
+++ b/core/camel-support/src/main/java/org/apache/camel/converter/stream/InputStreamCache.java
@@ -25,6 +25,8 @@ import org.apache.camel.StreamCache;
/**
* A {@link StreamCache} for caching using an in-memory byte array.
+ *
+ * @see StreamCache
*/
public final class InputStreamCache extends ByteArrayInputStream implements StreamCache {
diff --git a/core/camel-support/src/main/java/org/apache/camel/converter/stream/ReaderCache.java b/core/camel-support/src/main/java/org/apache/camel/converter/stream/ReaderCache.java
index 03ad1c283df..57bd24f4b45 100644
--- a/core/camel-support/src/main/java/org/apache/camel/converter/stream/ReaderCache.java
+++ b/core/camel-support/src/main/java/org/apache/camel/converter/stream/ReaderCache.java
@@ -24,7 +24,12 @@ import org.apache.camel.Exchange;
import org.apache.camel.StreamCache;
/**
- * A {@link org.apache.camel.StreamCache} for String {@link java.io.Reader}s
+ * A {@link org.apache.camel.StreamCache} for String {@link java.io.Reader}s.
+ * <p/>
+ * <b>Important:</b>
+ * All the classes from the Camel release that implements {@link StreamCache} is NOT intended for end users
+ * to create as instances, but they are part of
+ * Camels <a href="https://camel.apache.org/manual/stream-caching.html">stream-caching</a> functionality.
*/
public class ReaderCache extends StringReader implements StreamCache {
diff --git a/core/camel-xml-jaxp/src/main/java/org/apache/camel/util/xml/SourceCache.java b/core/camel-xml-jaxp/src/main/java/org/apache/camel/util/xml/SourceCache.java
index f101997aff2..5de6321e7c5 100644
--- a/core/camel-xml-jaxp/src/main/java/org/apache/camel/util/xml/SourceCache.java
+++ b/core/camel-xml-jaxp/src/main/java/org/apache/camel/util/xml/SourceCache.java
@@ -24,7 +24,12 @@ import org.apache.camel.StreamCache;
import org.apache.camel.util.IOHelper;
/**
- * {@link org.apache.camel.StreamCache} implementation for {@link StringSource}s
+ * {@link org.apache.camel.StreamCache} implementation for {@link StringSource}s.
+ * <p/>
+ * <b>Important:</b>
+ * All the classes from the Camel release that implements {@link StreamCache} is NOT intended for end users
+ * to create as instances, but they are part of
+ * Camels <a href="https://camel.apache.org/manual/stream-caching.html">stream-caching</a> functionality.
*/
public final class SourceCache extends StringSource implements StreamCache {
diff --git a/core/camel-xml-jaxp/src/main/java/org/apache/camel/util/xml/StreamSourceCache.java b/core/camel-xml-jaxp/src/main/java/org/apache/camel/util/xml/StreamSourceCache.java
index e800ee82c91..d3f27caf122 100644
--- a/core/camel-xml-jaxp/src/main/java/org/apache/camel/util/xml/StreamSourceCache.java
+++ b/core/camel-xml-jaxp/src/main/java/org/apache/camel/util/xml/StreamSourceCache.java
@@ -29,7 +29,12 @@ import org.apache.camel.converter.stream.ReaderCache;
import org.apache.camel.util.IOHelper;
/**
- * A {@link org.apache.camel.StreamCache} for {@link javax.xml.transform.stream.StreamSource}s
+ * A {@link org.apache.camel.StreamCache} for {@link javax.xml.transform.stream.StreamSource}s.
+ * <p/>
+ * <b>Important:</b>
+ * All the classes from the Camel release that implements {@link StreamCache} is NOT intended for end users
+ * to create as instances, but they are part of
+ * Camels <a href="https://camel.apache.org/manual/stream-caching.html">stream-caching</a> functionality.
*/
public final class StreamSourceCache extends StreamSource implements StreamCache {