Merge pull request #50 from Azure/dev

1.0.0-PREVIEW-1 release

Author: jtaubensee

README.md

@@ -6,6 +6,8 @@
 
 **Please be aware that this library is currently in active development, and is not intended for production**
 
+[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.microsoft.azure/azure-servicebus/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.microsoft.azure/azure-servicebus)
+
 This is the next generation Service Bus Java client library that focuses on Queues & Topics. If you are looking for Event Hubs, follow this [link](https://github.com/azure/azure-event-hubs-java).
 
 Azure Service Bus is an asynchronous messaging cloud platform that enables you to send messages between decoupled systems. Microsoft offers this feature as a service, which means that you do not need to host any of your own hardware in order to use it.
@@ -15,3 +17,15 @@ Refer to [azure.com](https://azure.microsoft.com/services/service-bus/) to learn
 ## How to provide feedback
 
 See our [Contribution Guidelines](./.github/CONTRIBUTING.md).
+
+## FAQ
+
+### Where can I find examples that use this library?
+
+To get started *sending* messages to Service Bus refer to [Get started sending to Service Bus queues](https://github.com/Azure/azure-service-bus/blob/master/samples/Java/src/main/java/com/microsoft/azure/servicebus/samples/SendSample.java).
+
+To get started *receiving* messages with Service Bus refer to [Get started receiving from Service Bus queues](https://github.com/Azure/azure-service-bus/blob/master/samples/Java/src/main/java/com/microsoft/azure/servicebus/samples/ReceiveSample.java).  
+
+### Can I manage Service Bus entities with this library?
+
+The standard way to manage Azure resources is by using [Azure Resource Manager](https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-overview). In order to use functionality that previously existed in the azure-servicebus Java library, there will be a new Java specific library before this library becomes generally available. This will enable use cases that dynamically create/read/update/delete resources, and will be similar to the currently available [.NET management library](https://www.nuget.org/packages/Microsoft.WindowsAzure.Management.ServiceBus/).

azure-servicebus-samples/pom.xml

@@ -26,6 +26,11 @@
 					<showWarnings>true</showWarnings>
 				</configuration>
 			</plugin>
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+	        	<artifactId>maven-surefire-plugin</artifactId>
+	        	<version>2.20</version>
+	      </plugin>
 		</plugins>
 	</build>
 

azure-servicebus-samples/src/main/java/com/microsoft/azure/servicebus/samples/ReceiveSample.java

@@ -0,0 +1,11 @@
+#entity names coming from the deployment template
+partitioned.queue.name = partitioned-queue
+non.partitioned.queue.name = non-partitioned-queue
+session.partitioned.queue.name = partitioned-session-queue
+session.non.partitioned.queue.name = non-partitioned-session-queue
+partitioned.topic.name = partitioned-topic
+non.partitioned.topic.name = non-partitioned-topic
+session.partitioned.topic.name = partitioned-session-topic
+session.non.partitioned.topic.name = non-partitioned-session-topic
+subscription.name = subscription
+session.subscription.name = session-subscription

azure-servicebus-samples/src/main/java/com/microsoft/azure/servicebus/samples/SendSample.java

@@ -45,13 +45,13 @@ public Instant getLockedUntilUtc() {
 	}
 
 	@Override
-	public int getMessagePrefetchCount()
+	public int getPrefetchCount()
 	{
 		throw new UnsupportedOperationException(INVALID_OPERATION_ERROR_MESSAGE);
 	}
 
 	@Override
-	public void setMessagePrefetchCount(int prefetchCount) throws ServiceBusException
+	public void setPrefetchCount(int prefetchCount) throws ServiceBusException
 	{
 		throw new UnsupportedOperationException(INVALID_OPERATION_ERROR_MESSAGE);
 	}

azure-servicebus/pom.xml

@@ -6,7 +6,7 @@
 import com.microsoft.azure.servicebus.primitives.MessagingFactory;
 import com.microsoft.azure.servicebus.primitives.ServiceBusException;
 
-class ClientFactory {
+public class ClientFactory {
 
 	private static final ReceiveMode DEFAULTRECEIVEMODE = ReceiveMode.PeekLock;
 

azure-servicebus/resources/access.properties.template

@@ -51,4 +51,8 @@ interface IMessageAndSessionPump
     CompletableFuture<Void> deadLetterAsync(UUID lockToken, String deadLetterReason, String deadLetterErrorDescription);
 
     CompletableFuture<Void> deadLetterAsync(UUID lockToken, String deadLetterReason, String deadLetterErrorDescription, Map<String, Object> propertiesToModify);
+    
+    int getPrefetchCount();
+    
+    void setPrefetchCount(int prefetchCount) throws ServiceBusException;
 }