connection.h

来自「lumaqq」· C头文件 代码 · 共 115 行

/*
 * LumaQQ - Cross platform QQ client, special edition for Mac
 *
 * Copyright (C) 2007 luma <[e-mail]>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 */

#import <Cocoa/Cocoa.h>
#import "ConnectionAdvisor.h"

@class NetworkLayer;

// represent a network connection, a connection is identified by an id
@interface Connection : NSObject <NSCopying> {
	// connection id
	NSNumber* m_connId;
	
	// connection parameters
	NSString* m_protocol;
	NSString* m_server;
	NSNumber* m_port;
	NSString* m_proxyType;
	NSString* m_proxyServer;
	NSNumber* m_proxyPort;
	NSString* m_proxyUsername;
	NSString* m_proxyPassword;
	
	// send queue
	NSMutableArray* m_sendQueue;
	
	// advisor id
	NSNumber* m_advisorId;
	id<ConnectionAdvisor> m_advisor;

	// socket
	int m_socket;
	
	// network layer reference
	NetworkLayer* m_network;
	
	// read buffer
	NSMutableData* m_buffer;
	int m_bufferPos;
	int m_readPos;
}

+ (int)nextAvailableConnectionId;

// initialization
- (id)initWithServer:(NSString*)server port:(int)port protocol:(NSString*)protocol;
- (id)initWithServer:(NSString*)server port:(int)port protocol:(NSString*)protocol proxyType:(NSString*)proxyType proxyServer:(NSString*)proxyServer proxyPort:(int)proxyPort proxyUsername:(NSString*)proxyUsername proxyPassword:(NSString*)proxyPassword;
- (id)copyWithNewAddress:(NSString*)newServer;

// encode/decode
- (NSData*)serialize;
+ (Connection*)deserialize:(NSData*)data;

// queue operation
- (BOOL)sendQueueEmpty;
- (NSData*)nextPacketData;
- (void)addPacketData:(NSData*)data;
- (void)compact;
- (void)flush;
- (void)write:(NSData*)data;
- (void)write:(const char*)bytes length:(int)length;
- (void)close;

// read buffer
- (void)put:(NSData*)data;
- (void)initReadBuffer;
- (NSData*)nextPacketRead;

// accessor
- (BOOL)isUdp;
- (NSNumber*)connectionId;
- (void)setConnectionId:(NSNumber*)connId;
- (NSString*)protocol;
- (void)setProtocol:(NSString*)protocol;
- (NSString*)server;
- (void)setServer:(NSString*)address;
- (NSNumber*)port;
- (void)setPort:(NSNumber*)port;
- (NSString*)proxyType;
- (void)setProxyType:(NSString*)type;
- (NSString*)proxyServer;
- (void)setProxyServer:(NSString*)address;
- (NSNumber*)proxyPort;
- (void)setProxyPort:(NSNumber*)value;
- (NSString*)proxyUsername;
- (void)setProxyUsername:(NSString*)username;
- (NSString*)proxyPassword;
- (void)setProxyPassword:(NSString*)pass;
- (NSNumber*)advisorId;
- (void)setAdvisorId:(NSNumber*)advisorId;
- (void)setAdvisor:(id<ConnectionAdvisor>)advisor;
- (void)setSocket:(int)socket;
- (int)socket;
- (void)setNetwork:(NetworkLayer*)network;
- (NetworkLayer*)network;

@end