updating java docs

Author: makam

azure-servicebus/src/main/java/com/microsoft/azure/servicebus/ClientFactory.java

@@ -685,8 +685,6 @@ public static CompletableFuture<IMessageSession> acceptSessionFromEntityPathAsyn
      * @param entityPath path of entity
      * @param sessionId session id, if null, service will return the first available session, otherwise, service will return specified session
      * @return a CompletableFuture representing the pending session accepting
-     * @throws InterruptedException if the current thread was interrupted while waiting
-     * @throws ServiceBusException if the session cannot be accepted
      */
     public static CompletableFuture<IMessageSession> acceptSessionFromEntityPathAsync(MessagingFactory messagingFactory, String entityPath, String sessionId) {
         return acceptSessionFromEntityPathAsync(messagingFactory, entityPath, sessionId, DEFAULTRECEIVEMODE);
@@ -699,8 +697,6 @@ public static CompletableFuture<IMessageSession> acceptSessionFromEntityPathAsyn
      * @param sessionId session id, if null, service will return the first available session, otherwise, service will return specified session
      * @param receiveMode PeekLock or ReceiveAndDelete
      * @return a CompletableFuture representing the pending session accepting
-     * @throws InterruptedException if the current thread was interrupted while waiting
-     * @throws ServiceBusException if the session cannot be accepted
      */
     public static CompletableFuture<IMessageSession> acceptSessionFromEntityPathAsync(MessagingFactory messagingFactory, String entityPath, String sessionId, ReceiveMode receiveMode) {
         Utils.assertNonNull("messagingFactory", messagingFactory);

azure-servicebus/src/main/java/com/microsoft/azure/servicebus/TransactionContext.java

@@ -39,8 +39,8 @@ public String toString() {
 
     /**
      * Commits the transaction
-     * @throws ServiceBusException
-     * @throws InterruptedException
+     * @throws ServiceBusException if Commit failed
+     * @throws InterruptedException if the current thread was interrupted while waiting
      */
     public void commit() throws ServiceBusException, InterruptedException {
         if (this.messagingFactory == null) {
@@ -52,6 +52,7 @@ public void commit() throws ServiceBusException, InterruptedException {
 
     /**
      * Asynchronously commits the transaction
+     * @return a CompletableFuture for the commit operation
      */
     public CompletableFuture<Void> commitAsync() {
         if (this.messagingFactory == null) {
@@ -65,8 +66,8 @@ public CompletableFuture<Void> commitAsync() {
 
     /**
      * Rollback the transaction
-     * @throws ServiceBusException
-     * @throws InterruptedException
+     * @throws ServiceBusException if rollback failed
+     * @throws InterruptedException if the current thread was interrupted while waiting
      */
     public void rollback() throws ServiceBusException, InterruptedException {
         if (this.messagingFactory == null) {
@@ -78,6 +79,7 @@ public void rollback() throws ServiceBusException, InterruptedException {
 
     /**
      * Asynchronously rollback the transaction.
+     * @return a CompletableFuture for the rollback operation
      */
     public CompletableFuture<Void> rollbackAsync() {
         if (this.messagingFactory == null) {
@@ -91,6 +93,7 @@ public CompletableFuture<Void> rollbackAsync() {
 
     /**
      * This is not to be called by the user.
+     * @param commit true indicates success and false for rollback
      */
     public void notifyTransactionCompletion(boolean commit) {
         if (txnHandler != null) {

azure-servicebus/src/main/java/com/microsoft/azure/servicebus/primitives/MessagingFactory.java

@@ -110,8 +110,8 @@ public void onReactorInit(Event e)
 	 * Starts a new service side transaction. The {@link TransactionContext} should be passed to all operations that
 	 * needs to be in this transaction.
 	 * @return a new transaction
-	 * @throws ServiceBusException
-	 * @throws InterruptedException
+	 * @throws ServiceBusException if transaction fails to start
+	 * @throws InterruptedException if the current thread was interrupted while waiting
 	 */
 	public TransactionContext startTransaction() throws ServiceBusException, InterruptedException {
 		return Utils.completeFuture(this.startTransactionAsync());
@@ -133,8 +133,8 @@ public CompletableFuture<TransactionContext> startTransactionAsync() {
 	 * @param transaction The transaction object.
 	 * @param commit A boolean value of <code>true</code> indicates transaction to be committed. A value of
 	 *                  <code>false</code> indicates a transaction rollback.
-	 * @throws ServiceBusException
-	 * @throws InterruptedException
+	 * @throws ServiceBusException if transaction fails to end
+	 * @throws InterruptedException if the current thread was interrupted while waiting
 	 */
     public void endTransaction(TransactionContext transaction, boolean commit) throws ServiceBusException, InterruptedException {
 		Utils.completeFuture(this.endTransactionAsync(transaction, commit));