你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

ServiceBusQueueTrigger Interface

  • Reference
Package:
com.microsoft.azure.functions.annotation
Maven Artifact:
com.microsoft.azure.functions:azure-functions-java-library:1.3.1

Implements

java.lang.annotation.Annotation

public interface ServiceBusQueueTrigger
implements java.lang.annotation.Annotation

Place this on a parameter whose value would come from a Service Bus queue, and causing the method to run when a new item is pushed. The parameter type can be one of the following:

  • Any native Java types such as int, String, byte[]
  • Nullable values using Optional
  • Any POJO type

The following example shows a Java function that logs a Service Bus queue message:

@FunctionName("serviceBusMonitor")
 public void logServiceBusMessage(
    @ServiceBusQueueTrigger(name = "msg", queueName = "myqueue", connection = "AzureServiceBusConnection") 
     final String message,
     final ExecutionContext context
 ) {
     context.getLogger().info("Message is received: " + message);
 }

Method Summary

Modifier and Type Method and Description
abstract AccessRights access()

Defines the permission of the Service Bus queue to which to bind.
abstract java.lang.String connection()

Defines the app setting name that contains the Service Bus connection string.
abstract java.lang.String dataType()

Defines how Functions runtime should treat the parameter value.
abstract boolean isSessionsEnabled()

Defines the value indicating whether the sessions are enabled.
abstract java.lang.String name()

The variable name used in function.json.
abstract java.lang.String queueName()

Defines the name of the Service Bus queue to which to bind.

Method Details

access

public abstract AccessRights access()

Defines the permission of the Service Bus queue to which to bind.

Returns:

The Service Bus queue permission.

connection

public abstract String connection()

Defines the app setting name that contains the Service Bus connection string.

Returns:

The app setting name of the connection string.

dataType

public abstract String dataType()

Defines how Functions runtime should treat the parameter value. Possible values are:

  • "": get the value as a string, and try to deserialize to actual parameter type like POJO
  • string: always get the value as a string
  • binary: get the value as a binary data, and try to deserialize to actual parameter type byte[]

Returns:

The dataType which will be used by the Functions runtime.

isSessionsEnabled

public abstract boolean isSessionsEnabled()

Defines the value indicating whether the sessions are enabled.

Returns:

The value indicating whether the sessions are enabled.

name

public abstract String name()

The variable name used in function.json.

Returns:

The variable name used in function.json.

queueName

public abstract String queueName()

Defines the name of the Service Bus queue to which to bind.

Returns:

The Service Bus queue string.

Applies to