Add support for joining rooms

FossilOrigin-Name: b1d8afb546f8999f2c6aba10ca589d2b31ba5e0df917230e265abb5b11474f65

src/exceptions/MTXClientException.h

@@ -29,16 +29,17 @@ OF_ASSUME_NONNULL_BEGIN
 @class MTXClient;
 
 @interface MTXClientException: OFException
-@property (readonly, nonatomic) MTXClient *client;
 @property (readonly, nonatomic) int statusCode;
 @property (readonly, nonatomic) mtx_response_t response;
+@property (readonly, nonatomic) MTXClient *client;
 
-+ (instancetype)exceptionWithClient: (MTXClient *)client
-			 statusCode: (int)statusCode
-			   response: (mtx_response_t)response;
-- (instancetype)initWithClient: (OFString *)user
-		    statusCode: (int)statusCode
-		      response: (mtx_response_t)response;
++ (instancetype)exceptionWithStatusCode: (int)statusCode
+			       response: (mtx_response_t)response
+				 client: (MTXClient *)client;
+- (instancetype)initWithStatusCode: (int)statusCode
+			  response: (mtx_response_t)respons
+			    client: (MTXClient *)client
+    OF_DESIGNATED_INITIALIZER;
 @end
 
 OF_ASSUME_NONNULL_END

src/exceptions/MTXClientException.m

@@ -25,25 +25,25 @@
 #import "MTXClient.h"
 
 @implementation MTXClientException
-+ (instancetype)exceptionWithClient: (MTXClient *)client
-			 statusCode: (int)statusCode
-			   response: (mtx_response_t)response
++ (instancetype)exceptionWithStatusCode: (int)statusCode
+			       response: (mtx_response_t)response
+				 client: (MTXClient *)client
 {
-	return [[[self alloc] initWithClient: client
-				  statusCode: statusCode
-				    response: response] autorelease];
+	return [[[self alloc] initWithStatusCode: statusCode
+					response: response
+					  client: client] autorelease];
 }
 
-- (instancetype)initWithClient: (MTXClient *)client
-		    statusCode: (int)statusCode
-		      response: (mtx_response_t)response
+- (instancetype)initWithStatusCode: (int)statusCode
+			  response: (mtx_response_t)response
+			    client: (MTXClient *)client
 {
 	self = [super init];
 
 	@try {
-		_client = [client retain];
 		_statusCode = statusCode;
 		_response = [response copy];
+		_client = [client retain];
 	} @catch (id e) {
 		[self release];
 		@throw e;
@@ -54,8 +54,8 @@
 
 - (void)dealloc
 {
-	[_client release];
 	[_response release];
+	[_client release];
 
 	[super dealloc];
 }

src/exceptions/MTXJoinRoomFailedException.h

@@ -0,0 +1,48 @@
+/*
+ * Copyright (c) 2020, Jonathan Schleifer <js@nil.im>
+ *
+ * https://fossil.nil.im/objmatrix
+ *
+ * Permission to use, copy, modify, and/or distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice is present in all copies.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#import <ObjFW/ObjFW.h>
+
+#import "MTXClientException.h"
+
+OF_ASSUME_NONNULL_BEGIN
+
+@interface MTXJoinRoomFailedException: MTXClientException
+@property (readonly, nonatomic) OFString *room;
+
++ (instancetype)exceptionWithStatusCode: (int)statusCode
+			       response: (mtx_response_t)response
+				 client: (MTXClient *)client OF_UNAVAILABLE;
++ (instancetype)exceptionWithRoom: (OFString *)room
+		       statusCode: (int)statusCode
+			 response: (mtx_response_t)response
+			   client: (MTXClient *)client;
+- (instancetype)initWithStatusCode: (int)statusCode
+			  response: (mtx_response_t)response
+			    client: (MTXClient *)client OF_UNAVAILABLE;
+- (instancetype)initWithRoom: (OFString *)room
+		  statusCode: (int)statusCode
+		    response: (mtx_response_t)response
+		      client: (MTXClient *)client;
+@end
+
+OF_ASSUME_NONNULL_END

src/exceptions/MTXJoinRoomFailedException.m

@@ -0,0 +1,71 @@
+/*
+ * Copyright (c) 2020, Jonathan Schleifer <js@nil.im>
+ *
+ * https://fossil.nil.im/objmatrix
+ *
+ * Permission to use, copy, modify, and/or distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice is present in all copies.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#import "MTXJoinRoomFailedException.h"
+
+#import "MTXClient.h"
+
+@implementation MTXJoinRoomFailedException
++ (instancetype)exceptionWithRoom: (OFString *)room
+		       statusCode: (int)statusCode
+			 response: (mtx_response_t)response
+			   client: (MTXClient *)client
+{
+	return [[[self alloc] initWithRoom: room
+				statusCode: statusCode
+				  response: response
+				    client: client] autorelease];
+}
+
+- (instancetype)initWithRoom: (OFString *)room
+		  statusCode: (int)statusCode
+		    response: (mtx_response_t)response
+		      client: (MTXClient *)client
+{
+	self = [super initWithStatusCode: statusCode
+				response: response
+				  client: client];
+
+	@try {
+		_room = [room copy];
+	} @catch (id e) {
+		[self release];
+		@throw e;
+	}
+
+	return self;
+}
+
+- (void)dealloc
+{
+	[_room release];
+
+	[super dealloc];
+}
+
+- (OFString *)description
+{
+	return [OFString stringWithFormat:
+	    @"Failed to join room %@ for %@: %@",
+	    _room, self.client.userID, self.response];
+}
+@end

src/exceptions/Makefile

@@ -5,6 +5,7 @@ STATIC_LIB_NOINST = ${EXCEPTIONS_A}
 
 SRCS = MTXClientException.m			\
        MTXFetchRoomListFailedException.m	\
+       MTXJoinRoomFailedException.m		\
        MTXLoginFailedException.m		\
        MTXLogoutFailedException.m
 INCLUDES = ${SRCS:.m=.h}