Microsoft Azure Functions Java SignalR Types

This package contains all Java interfaces and annotations to interact with Microsoft Azure functions runtime for SignalR Service.

License

License

Categories

Categories

Java Languages
GroupId

GroupId

com.microsoft.azure.functions
ArtifactId

ArtifactId

azure-functions-java-library-signalr
Last Version

Last Version

1.0.0
Release Date

Release Date

Type

Type

jar
Description

Description

Microsoft Azure Functions Java SignalR Types
This package contains all Java interfaces and annotations to interact with Microsoft Azure functions runtime for SignalR Service.
Project URL

Project URL

https://docs.microsoft.com/en-us/azure/azure-functions/functions-bindings-signalr-service
Project Organization

Project Organization

Microsoft Azure
Source Code Management

Source Code Management

https://github.com/Azure/azure-functions-signalrservice-extension

Download azure-functions-java-library-signalr

How to add to project

<!-- https://jarcasting.com/artifacts/com.microsoft.azure.functions/azure-functions-java-library-signalr/ -->
<dependency>
    <groupId>com.microsoft.azure.functions</groupId>
    <artifactId>azure-functions-java-library-signalr</artifactId>
    <version>1.0.0</version>
</dependency>
// https://jarcasting.com/artifacts/com.microsoft.azure.functions/azure-functions-java-library-signalr/
implementation 'com.microsoft.azure.functions:azure-functions-java-library-signalr:1.0.0'
// https://jarcasting.com/artifacts/com.microsoft.azure.functions/azure-functions-java-library-signalr/
implementation ("com.microsoft.azure.functions:azure-functions-java-library-signalr:1.0.0")
'com.microsoft.azure.functions:azure-functions-java-library-signalr:jar:1.0.0'
<dependency org="com.microsoft.azure.functions" name="azure-functions-java-library-signalr" rev="1.0.0">
  <artifact name="azure-functions-java-library-signalr" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.microsoft.azure.functions', module='azure-functions-java-library-signalr', version='1.0.0')
)
libraryDependencies += "com.microsoft.azure.functions" % "azure-functions-java-library-signalr" % "1.0.0"
[com.microsoft.azure.functions/azure-functions-java-library-signalr "1.0.0"]

Dependencies

compile (1)

Group / Artifact Type Version
com.microsoft.azure.functions : azure-functions-java-library jar 1.3.0

Project Modules

There are no modules declared in this project.

Azure Functions Bindings for Azure SignalR Service

Build Status

Travis: travis

NuGet Packages

Package Name Target Framework NuGet
Microsoft.Azure.WebJobs.Extensions.SignalRService .NET Standard 2.0 NuGet

Intro

These bindings allow Azure Functions to integrate with Azure SignalR Service.

Supported scenarios

  • Allow clients to serverlessly connect to a SignalR Service hub without requiring an ASP.NET Core backend
  • Use Azure Functions (any language supported by V2) to broadcast messages to all clients connected to a SignalR Service hub.
  • Use Azure Functions (any language supported by V2) to send messages to a single user, or all the users in a group.
  • Use Azure Functions (any language supported by V2) to manage group users like add/remove a single user in a group.
  • Example scenarios include: broadcast messages to a SignalR Service hub on HTTP requests and events from Cosmos DB change feed, Event Hub, Event Grid, etc

Bindings

SignalRConnectionInfo input binding makes it easy to generate the token required for clients to initiate a connection to Azure SignalR Service.

SignalR output binding allows messages to be broadcast to an Azure SignalR Service hub.

Current limitations

  • Cannot invoke methods on a subset of connections.
  • Functions cannot be triggered by client invocation of server methods (clients need to call an HTTP endpoint or post messages to a Event Grid, etc, to trigger a function)

Prerequisites

Usage

Create Azure SignalR Service instance

  1. Create an Azure SignalR Service instance in the Azure Portal. Note the connection string, you'll need this later.

Create Function App with extension

  1. In a new folder, create a new Azure Functions app.
    • func init
  2. Install this Functions extension.
    • func extensions install -p Microsoft.Azure.WebJobs.Extensions.SignalRService -v 1.0.0

Add application setting for SignalR connection string

  1. Create an app setting called AzureSignalRConnectionString with the SignalR connection string.
    • On localhost, use local.settings.json
    • In Azure, use App Settings

Using the SignalRConnectionInfo input binding

In order for a client to connect to SignalR, it needs to obtain the SignalR Service client hub URL and an access token.

  1. Create a new function named negotiate and use the SignalRConnectionInfo input binding to obtain the connection information and return it. Take a look at this sample.
  2. Client connects to the negotiate function as it's a normal SignalR hub. See this file for a sample usage.

Binding schema:

{
  "type": "signalRConnectionInfo",
  "name": "connectionInfo",
  "hubName": "<hub_name>",
  "connectionStringSetting": "<setting_name>", // Defaults to AzureSignalRConnectionString
  "direction": "in"
}

Using the SignalR output binding

The SignalR output binding can be used to broadcast messages to all clients connected a hub. Take a look at this sample:

Binding schema:

{
  "type": "signalR",
  "name": "signalRMessages", // name of the output binding
  "hubName": "<hub_name>",
  "connectionStringSetting": "<setting_name>", // Defaults to AzureSignalRConnectionString
  "direction": "out"
}

To send one or more messages, set the output binding to an array of objects:

module.exports = function (context, req) {
  context.bindings.signalRMessages = [{
    "target": "newMessage", // name of the client method to invoke
    "arguments": [
      req.body // arguments to pass to client method
    ]
  }];
  context.done();
};

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

com.microsoft.azure.functions

Microsoft Azure

APIs, SDKs and open source projects from Microsoft Azure

Versions

Version
1.0.0