org.apache.activemq.blob.BlobTransferPolicy Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of activemq-core Show documentation
Show all versions of activemq-core Show documentation
The ActiveMQ Message Broker and Client implementations
/**
* 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.activemq.blob;
import java.net.MalformedURLException;
import java.net.URL;
/**
* The policy for configuring how BLOBs (Binary Large OBjects) are transferred
* out of band between producers, brokers and consumers.
*
* @version $Revision: $
*/
public class BlobTransferPolicy {
private String defaultUploadUrl = "http://localhost:8080/uploads/";
private String brokerUploadUrl;
private String uploadUrl;
private int bufferSize = 128 * 1024;
private BlobUploadStrategy uploadStrategy;
private BlobDownloadStrategy downloadStrategy;
/**
* Returns a copy of this policy object
*/
public BlobTransferPolicy copy() {
BlobTransferPolicy that = new BlobTransferPolicy();
that.defaultUploadUrl = this.defaultUploadUrl;
that.brokerUploadUrl = this.brokerUploadUrl;
that.uploadUrl = this.uploadUrl;
that.uploadStrategy = this.uploadStrategy;
return that;
}
public String getUploadUrl() {
if (uploadUrl == null) {
uploadUrl = getBrokerUploadUrl();
if (uploadUrl == null) {
uploadUrl = getDefaultUploadUrl();
}
}
return uploadUrl;
}
/**
* Sets the upload URL to use explicitly on the client which will
* overload the default or the broker's URL. This allows the client to decide
* where to upload files to irrespective of the brokers configuration.
*/
public void setUploadUrl(String uploadUrl) {
this.uploadUrl = uploadUrl;
}
public String getBrokerUploadUrl() {
return brokerUploadUrl;
}
/**
* Called by the JMS client when a broker advertises its upload URL
*/
public void setBrokerUploadUrl(String brokerUploadUrl) {
this.brokerUploadUrl = brokerUploadUrl;
}
public String getDefaultUploadUrl() {
return defaultUploadUrl;
}
/**
* Sets the default upload URL to use if the broker does not
* have a configured upload URL
*/
public void setDefaultUploadUrl(String defaultUploadUrl) {
this.defaultUploadUrl = defaultUploadUrl;
}
public BlobUploadStrategy getUploadStrategy() {
if (uploadStrategy == null) {
uploadStrategy = createUploadStrategy();
}
return uploadStrategy;
}
public BlobDownloadStrategy getDownloadStrategy() {
if(downloadStrategy == null) {
downloadStrategy = createDownloadStrategy();
}
return downloadStrategy;
}
/**
* Sets the upload strategy to use for uploading BLOBs to some URL
*/
public void setUploadStrategy(BlobUploadStrategy uploadStrategy) {
this.uploadStrategy = uploadStrategy;
}
public int getBufferSize() {
return bufferSize;
}
/**
* Sets the default buffer size used when uploading or downloading files
*/
public void setBufferSize(int bufferSize) {
this.bufferSize = bufferSize;
}
/**
* Returns the upload strategy depending on the information from the
* uploadURL. Currently supportet HTTP and FTP
*
* @return
*/
protected BlobUploadStrategy createUploadStrategy() {
BlobUploadStrategy strategy;
try {
URL url = new URL(getUploadUrl());
if(url.getProtocol().equalsIgnoreCase("FTP")) {
strategy = new FTPBlobUploadStrategy(this);
} else {
strategy = new DefaultBlobUploadStrategy(this);
}
} catch (MalformedURLException e) {
strategy = new DefaultBlobUploadStrategy(this);
}
return strategy;
}
/**
* Returns the download strategy depending on the information from the
* uploadURL. Currently supportet HTTP and FTP
*
* @return
*/
protected BlobDownloadStrategy createDownloadStrategy() {
BlobDownloadStrategy strategy;
try {
URL url = new URL(getUploadUrl());
if(url.getProtocol().equalsIgnoreCase("FTP")) {
strategy = new FTPBlobDownloadStrategy();
} else {
strategy = new DefaultBlobDownloadStrategy();
}
} catch (MalformedURLException e) {
strategy = new DefaultBlobDownloadStrategy();
}
return strategy;
}
}