rabbitmq objc client

RabbitMQ client for Objective-C and Swift

rabbitmq

224

Objective-C

RabbitMQ Objective-C and Swift client

A RabbitMQ client, largely influenced by Bunny.

Test-driven from Swift and implemented in Objective-C.

Supported iOS and macOS Versions

This library currently targets iOS 12+ and macOS 10.12+.

Dependencies

This library depends on

Installation with Carthage

Create a Cartfile with the following line:

github "rabbitmq/rabbitmq-objc-client" "v0.13.0"

Run Carthage, for example in a new project:

carthage bootstrap

In your Xcode project, in the Build Phases section of your target, open up Link
Binary With Libraries. Now drag e.g. Carthage/Build/iOS/RMQClient.framework
(choose Mac for OSX) into this list.
If you don’t already have one, click the ‘+’ icon under Build Phases to add a
Copy Files phase.
Under Destination, choose Frameworks.
Click the ‘+’ and add RMQClient.framework. Ensure Code Sign On Copy is checked.

Installation with CocoaPods

Add the following to your Podfile:
```
pod 'RMQClient', git: 'https://github.com/rabbitmq/rabbitmq-objc-client.git'
```
We recommend adding use_frameworks! to enable modular imports (Objective-C only).
Run pod install.
Open your project with open MyProject.xcworkspace.

Objective-C users: importing with @import RMQClient; currently produces an error in Xcode (Could not build module ‘RMQClient’), but this should not prevent code from compiling and running. Using crocodile imports avoids this Xcode bug: #import <RMQClient/RMQClient.h>.

Supported Features

[x] Publish and consume messages as strings
[x] Manipulate queues, exchanges, bindings and consumers.
[x] Asynchronous API using GCD queues under the hood (a delegate receives errors on a configurable GCD queue).
[x] Configurable recovery from network interruption and connection-level exceptions
[x] TLS support
[x] Client heartbeats
[x] Carthage support
[x] CocoaPods support
[x] iOS support
[x] MacOS support
[x] PKCS12 client certificates on iOS using the TLS auth mechanism plugin
[ ] PKCS12 support for MacOS
[ ] PKCS12 client certificates on iOS using chained CAs
[x] Publisher confirmations
[x] Publish and consume messages as data
[x] Customisable consumer hooks
[ ] Connection closure when broker doesn’t send heartbeats on schedule
[ ] basic.return support
[ ] Acknowledgement transaction support

Documentation

Several RabbitMQ tutorials are provided for
this client library.

(Basic) Usage Example

Instantiate an RMQConnection:

let delegate = RMQConnectionDelegateLogger() // implement RMQConnectionDelegate yourself to react to errors
let conn = RMQConnection(uri: "amqp://guest:guest@localhost:5672", delegate: delegate)

Connect:
```
conn.start()
```
Create a channel:
```
let ch = conn.createChannel()
```

Use the channel:

let q = ch.queue("myqueue")
q.subscribe({ m in
   print("Received: \(String(data: m.body, encoding: String.Encoding.utf8))")
})
q.publish("foo".data(using: String.Encoding.utf8))

Close the connection when done:
```
conn.close()
```

See the tutorials for more detailed instructions.

Running Tests

See CONTRIBUTING.md.

License and Copyright

This package, the RabbitMQ Objective-C client library, is
dual-licensed under the Mozilla Public License 2.0 (“MPL”) and the
Apache License version 2 (“ASL”).