Source/DCMessageContextDisplayPlugin.m
author Zachary West <zacw@adium.im>
Wed Nov 25 22:28:47 2009 -0500 (2009-11-25)
changeset 2820 37f86ef91f64
parent 2798 13548a608dd3
child 2821 fa988de96a94
permissions -rw-r--r--
Code simplification; remove the old preferences, and don't use a static variable to count the lines. Refs #13362.

I can't imagine using a static variable like this wouldn't cause problems, especially with "save chats" enabled; we'd be messing with the same static variable like crazy. I'm betting this explains some weird context problems, so let's see if this helps #13362.
     1 /* 
     2  * Adium is the legal property of its developers, whose names are listed in the copyright file included
     3  * with this source distribution.
     4  * 
     5  * This program is free software; you can redistribute it and/or modify it under the terms of the GNU
     6  * General Public License as published by the Free Software Foundation; either version 2 of the License,
     7  * or (at your option) any later version.
     8  * 
     9  * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even
    10  * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
    11  * Public License for more details.
    12  * 
    13  * You should have received a copy of the GNU General Public License along with this program; if not,
    14  * write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
    15  */
    16 
    17 #import <Adium/AIContentControllerProtocol.h>
    18 #import "DCMessageContextDisplayPlugin.h"
    19 #import "DCMessageContextDisplayPreferences.h"
    20 #import <AIUtilities/AIDictionaryAdditions.h>
    21 #import <Adium/AIChat.h>
    22 #import <Adium/AIContentContext.h>
    23 #import <Adium/AIService.h>
    24 
    25 //Old school
    26 #import <Adium/AIListContact.h>
    27 #import <AIUtilities/AIAttributedStringAdditions.h>
    28 #import <Adium/AIAccountControllerProtocol.h>
    29 
    30 //omg crawsslinkz
    31 #import "AILoggerPlugin.h"
    32 
    33 //LMX
    34 #import <LMX/LMXParser.h>
    35 #import <Adium/AIXMLElement.h>
    36 #import <AIUtilities/AIStringAdditions.h>
    37 #import "unistd.h"
    38 #import <AIUtilities/NSCalendarDate+ISO8601Parsing.h>
    39 #import <Adium/AIContactControllerProtocol.h>
    40 #import <Adium/AIHTMLDecoder.h>
    41 
    42 #define RESTORED_CHAT_CONTEXT_LINE_NUMBER 50
    43 
    44 /**
    45  * @class DCMessageContextDisplayPlugin
    46  * @brief Component to display in-window message history
    47  *
    48  * The amount of history, and criteria of when to display history, are determined in the Advanced->Message History preferences.
    49  */
    50 @interface DCMessageContextDisplayPlugin ()
    51 - (void)preferencesChangedForGroup:(NSString *)group key:(NSString *)key
    52 							object:(AIListObject *)object preferenceDict:(NSDictionary *)prefDict firstTime:(BOOL)firstTime;
    53 - (NSArray *)contextForChat:(AIChat *)chat;
    54 @end
    55 
    56 @implementation DCMessageContextDisplayPlugin
    57 
    58 /**
    59  * @brief Install
    60  */
    61 - (void)installPlugin
    62 {
    63 	isObserving = NO;
    64 	
    65 	//Setup our preferences
    66     [adium.preferenceController registerDefaults:[NSDictionary dictionaryNamed:CONTEXT_DISPLAY_DEFAULTS
    67 																		forClass:[self class]] 
    68 										  forGroup:PREF_GROUP_CONTEXT_DISPLAY];
    69 	
    70 	//Observe preference changes for whether or not to display message history
    71 	[adium.preferenceController registerPreferenceObserver:self forGroup:PREF_GROUP_CONTEXT_DISPLAY];
    72 }
    73 
    74 /**
    75  * @brief Uninstall
    76  */
    77 - (void)uninstallPlugin
    78 {
    79 	[adium.preferenceController unregisterPreferenceObserver:self];
    80 	[[NSNotificationCenter defaultCenter] removeObserver:self];
    81 }
    82 
    83 - (void)preferencesChangedForGroup:(NSString *)group key:(NSString *)key
    84 								object:(AIListObject *)object preferenceDict:(NSDictionary *)prefDict firstTime:(BOOL)firstTime
    85 {
    86 	if (!object) {		
    87 		shouldDisplay = [[prefDict objectForKey:KEY_DISPLAY_CONTEXT] boolValue];
    88 		linesToDisplay = [[prefDict objectForKey:KEY_DISPLAY_LINES] integerValue];
    89 
    90 		if (shouldDisplay && linesToDisplay > 0 && !isObserving) {
    91 			//Observe new message windows only if we aren't already observing them
    92 			isObserving = YES;
    93 			[[NSNotificationCenter defaultCenter] addObserver:self
    94 										   selector:@selector(addContextDisplayToWindow:)
    95 											   name:Chat_DidOpen 
    96 											 object:nil];
    97 			
    98 		} else if (isObserving && (!shouldDisplay || linesToDisplay <= 0)) {
    99 			//Remove observer
   100 			isObserving = NO;
   101 			[[NSNotificationCenter defaultCenter] removeObserver:self name:Chat_DidOpen object:nil];
   102 			
   103 		}
   104 	}
   105 }
   106 
   107 /**
   108  * @brief Retrieve and display in-window message history
   109  *
   110  * Called in response to the Chat_DidOpen notification
   111  */
   112 - (void)addContextDisplayToWindow:(NSNotification *)notification
   113 {
   114 	AIChat	*chat = (AIChat *)[notification object];
   115 	
   116 	NSArray	*context = [self contextForChat:chat];
   117 
   118 	if (context && [context count] > 0 && shouldDisplay) {
   119 		AIContentContext	*contextMessage;
   120 
   121 		for(contextMessage in context) {
   122 			/* Don't display immediately, so the message view can aggregate multiple message history items.
   123 			 * As required, we post Content_ChatDidFinishAddingUntrackedContent when finished adding. */
   124 			[contextMessage setDisplayContentImmediately:NO];
   125 		
   126 			[adium.contentController displayContentObject:contextMessage
   127 										usingContentFilters:YES
   128 												immediately:YES];
   129 		}
   130 
   131 		//We finished adding untracked content
   132 		[[NSNotificationCenter defaultCenter] postNotificationName:Content_ChatDidFinishAddingUntrackedContent
   133 												  object:chat];
   134 	}
   135 }
   136 /*!
   137  * @brief Retrieve the message history for a particular chat
   138  *
   139  * Asks AILoggerPlugin for the path to the right file, and then uses LMX to parse that file backwards.
   140  */
   141 - (NSArray *)contextForChat:(AIChat *)chat
   142 {
   143 	//If there's no log there, there's no message history. Bail out.
   144 	NSArray *logPaths = [AILoggerPlugin sortedArrayOfLogFilesForChat:chat];
   145 	if(!logPaths) return nil;
   146 	
   147 	NSInteger linesLeftToFind = 0;
   148 
   149 	AIHTMLDecoder *decoder = [AIHTMLDecoder decoder];
   150 
   151 	NSString *logObjectUID = chat.name;
   152 	if (!logObjectUID) logObjectUID = chat.listObject.UID;
   153 	logObjectUID = [logObjectUID safeFilenameString];
   154 
   155 	NSString *baseLogPath = [[AILoggerPlugin logBasePath] stringByAppendingPathComponent:
   156 		[AILoggerPlugin relativePathForLogWithObject:logObjectUID onAccount:chat.account]];	
   157 
   158 	if ([chat boolValueForProperty:@"Restored Chat"] && linesToDisplay < RESTORED_CHAT_CONTEXT_LINE_NUMBER) {
   159 		linesLeftToFind = MAX(linesLeftToFind, RESTORED_CHAT_CONTEXT_LINE_NUMBER);
   160 	} else {
   161 		linesLeftToFind = linesToDisplay;		
   162 	}
   163 			
   164 	//Initialize a place to store found messages
   165 	NSMutableArray *outerFoundContentContexts = [NSMutableArray arrayWithCapacity:linesLeftToFind]; 
   166 
   167 	//Iterate over the elements of the log path array.
   168 	NSEnumerator *pathsEnumerator = [logPaths objectEnumerator];
   169 	NSString *logPath = nil;
   170 	while (linesLeftToFind > 0 && (logPath = [pathsEnumerator nextObject])) {
   171 		//If it's not a .chatlog, ignore it.
   172 		if (![logPath hasSuffix:@".chatlog"])
   173 			continue;
   174 				
   175 		//Stick the base path on to the beginning
   176 		logPath = [baseLogPath stringByAppendingPathComponent:logPath];
   177 
   178 		//By default, the xmlFilePath is the chat log file/bundle... if we find that the chatlog is a bundle, we'll use the xml file inside.
   179 		NSString *xmlFilePath = logPath;
   180 
   181 		BOOL isDir;
   182 		if ([[NSFileManager defaultManager] fileExistsAtPath:logPath isDirectory:&isDir]) {
   183 			/* If we have a chatLog bundle, we want to get the text content for the xml file inside */
   184 			NSString *baseURL;
   185 			if (isDir) {
   186 				baseURL = logPath;
   187 				xmlFilePath = [logPath stringByAppendingPathComponent:
   188 							   [[[logPath lastPathComponent] stringByDeletingPathExtension] stringByAppendingPathExtension:@"xml"]];
   189 			} else {
   190 				baseURL = nil;
   191 			}
   192 			[decoder setBaseURL:baseURL];
   193 		}
   194 
   195 		//Initialize the found messages array and element stack for us-as-delegate
   196 		foundMessages = [NSMutableArray arrayWithCapacity:linesLeftToFind];
   197 		elementStack = [NSMutableArray array];
   198 
   199 		//Create the parser and set ourselves as the delegate
   200 		LMXParser *parser = [LMXParser parser];
   201 		[parser setDelegate:self];
   202 
   203 		//Set up info needed by elementStarted to create content objects.
   204 		NSMutableDictionary *contextInfo = nil;
   205 		{
   206 			//Get the service name from the path name
   207 			NSString *serviceName = [[[[[logPath stringByDeletingLastPathComponent] stringByDeletingLastPathComponent] lastPathComponent] componentsSeparatedByString:@"."] objectAtIndex:0U];
   208 
   209 			AIListObject *account = chat.account;
   210 			NSString	 *accountID = [NSString stringWithFormat:@"%@.%@", account.service.serviceID, account.UID];
   211 
   212 			contextInfo = [NSMutableDictionary dictionaryWithObjectsAndKeys:
   213 						   serviceName, @"Service name",
   214 						   account, @"Account",
   215 						   accountID, @"Account ID",
   216 						   chat, @"Chat",
   217 						   decoder, @"AIHTMLDecoder",
   218 						   [NSValue valueWithPointer:&linesLeftToFind], @"LinesLeftToFindValue",
   219 						   nil];
   220 			[parser setContextInfo:(void *)contextInfo];
   221 		}
   222 
   223 		//Open up the file we need to read from, and seek to the end (this is a *backwards* parser, after all :)
   224 		NSFileHandle *file = [NSFileHandle fileHandleForReadingAtPath:xmlFilePath];
   225 		[file seekToEndOfFile];
   226 		
   227 		//Set up some more doohickeys and then start the parse loop
   228 		NSInteger readSize = 4 * getpagesize(); //Read 4 pages at a time.
   229 		NSMutableData *chunk = [NSMutableData dataWithLength:readSize];
   230 		NSInteger fd = [file fileDescriptor];
   231 		char *buf = [chunk mutableBytes];
   232 		off_t offset = [file offsetInFile];
   233 		enum LMXParseResult result = LMXParsedIncomplete;
   234 
   235 		parsingAutoreleasePool = [[NSAutoreleasePool alloc] init];
   236 
   237 		do {
   238 			//Calculate the new offset
   239 			offset = (offset <= readSize) ? 0 : offset - readSize;
   240 			
   241 			//Seek to it and read greedily until we hit readSize or run out of file.
   242 			NSInteger idx = 0;
   243 			for (ssize_t amountRead = 0; idx < readSize; idx += amountRead) { 
   244 				amountRead = pread(fd, buf + idx, readSize, offset + idx); 
   245 			   if (amountRead <= 0) break;
   246 			}
   247 			offset -= idx;
   248 			
   249 			//Parse
   250 			result = [parser parseChunk:chunk];
   251 			
   252 		//Continue to parse as long as we need more elements, we have data to read, and LMX doesn't think we're done.
   253 		} while ([foundMessages count] < linesLeftToFind && offset > 0 && result != LMXParsedCompletely);
   254 
   255 		//Pop our autorelease pool.
   256 		[parsingAutoreleasePool release]; parsingAutoreleasePool = nil;
   257 
   258 		//Be a good citizen and close the file
   259 		[file closeFile];
   260 
   261 		//Add our locals to the outer array; we're probably looping again.
   262 		[outerFoundContentContexts replaceObjectsInRange:NSMakeRange(0, 0) withObjectsFromArray:foundMessages];
   263 		linesLeftToFind -= [outerFoundContentContexts count];
   264 	}
   265 	
   266 	if (linesLeftToFind > 0) {
   267 		AILogWithSignature(@"Unable to find %d logs for %@", linesLeftToFind, chat);
   268 	}
   269 	
   270 	return outerFoundContentContexts;
   271 }
   272 
   273 #pragma mark LMX delegate
   274 
   275 - (void)parser:(LMXParser *)parser elementEnded:(NSString *)elementName
   276 {
   277 	if ([elementName isEqualToString:@"message"]) {
   278 		[elementStack insertObject:[AIXMLElement elementWithName:elementName] atIndex:0U];
   279 	}
   280 	else if ([elementStack count]) {
   281 		AIXMLElement *element = [AIXMLElement elementWithName:elementName];
   282 		[(AIXMLElement *)[elementStack objectAtIndex:0U] insertObject:element atIndex:0U];
   283 		[elementStack insertObject:element atIndex:0U];
   284 	}
   285 }
   286 
   287 - (void)parser:(LMXParser *)parser foundCharacters:(NSString *)string
   288 {
   289 	if ([elementStack count])
   290 		[(AIXMLElement *)[elementStack objectAtIndex:0U] insertObject:string atIndex:0U];
   291 }
   292 
   293 - (void)parser:(LMXParser *)parser elementStarted:(NSString *)elementName attributes:(NSDictionary *)attributes
   294 {
   295 	if ([elementStack count]) {
   296 		AIXMLElement *element = [elementStack objectAtIndex:0U];
   297 		if (attributes) {
   298 			[element setAttributeNames:[attributes allKeys] values:[attributes allValues]];
   299 		}
   300 		
   301 		NSMutableDictionary *contextInfo = [parser contextInfo];
   302 
   303 		if ([elementName isEqualToString:@"message"]) {
   304 			//A message element has started!
   305 			//This means that we have all of this message now, and therefore can create a single content object from the AIXMLElement tree and then throw away that tree.
   306 			//This saves memory when a message element contains many elements (since each one is represented by an AIXMLElement sub-tree in the AIXMLElement tree, as opposed to a simple NSAttributeRun in the NSAttributedString of the content object).
   307 
   308 			NSString     *serviceName = [contextInfo objectForKey:@"Service name"];
   309 			AIListObject *account     = [contextInfo objectForKey:@"Account"];
   310 			NSString     *accountID   = [contextInfo objectForKey:@"Account ID"];
   311 			AIChat       *chat        = [contextInfo objectForKey:@"Chat"];
   312 			
   313 			//Set up some doohickers.
   314 			NSDictionary	*attributes = [element attributes];
   315 			NSString		*timeString = [attributes objectForKey:@"time"];
   316 			//Create the context object
   317 			if (timeString) {
   318 				NSCalendarDate *time = [NSCalendarDate calendarDateWithString:timeString];
   319 
   320 				NSString		*autoreplyAttribute = [attributes objectForKey:@"auto"];
   321 				NSString		*sender = [NSString stringWithFormat:@"%@.%@", serviceName, [attributes objectForKey:@"sender"]];
   322 				BOOL			sentByMe = ([sender isEqualToString:accountID]);
   323 				
   324 				/*don't fade the messages if they're within the last 5 minutes
   325 				 *since that will be resuming a conversation, not starting a new one.
   326 				 *Why the class trickery? Less code duplication, clearer what is actually different between the two cases.
   327 				 */
   328 				Class messageClass = (-[time timeIntervalSinceNow] > 300.0) ? [AIContentContext class] : [AIContentMessage class];
   329 				
   330 				AIListContact *listContact = nil;
   331 				
   332 				if (chat.isGroupChat) {
   333 					listContact = [chat.account contactWithUID:[attributes objectForKey:@"sender"]];
   334 				} else {
   335 					listContact = chat.listObject;
   336 				}
   337 				
   338 				AIContentMessage *message = [messageClass messageInChat:chat 
   339 															 withSource:(sentByMe ? account : listContact)
   340 															destination:(sentByMe ? (chat.isGroupChat ? nil : chat.listObject) : account)
   341 																   date:time
   342 																message:[[contextInfo objectForKey:@"AIHTMLDecoder"] decodeHTML:[element contentsAsXMLString]]
   343 															  autoreply:(autoreplyAttribute && [autoreplyAttribute caseInsensitiveCompare:@"true"] == NSOrderedSame)];
   344 				
   345 				//Don't log this object
   346 				[message setPostProcessContent:NO];
   347 				[message setTrackContent:NO];
   348 
   349 				//Add it to the array (in front, since we're working backwards, and we want the array in forward order)
   350 				[foundMessages insertObject:message atIndex:0];
   351 			} else {
   352 				NSLog(@"Null message context display time for %@",element);
   353 			}
   354 		}
   355 		
   356 		NSInteger	 *linesLeftToFind = [[contextInfo objectForKey:@"LinesLeftToFindValue"] pointerValue];
   357 
   358 		[elementStack removeObjectAtIndex:0U];
   359 		if ([foundMessages count] == *linesLeftToFind) {
   360 			if ([elementStack count]) [elementStack removeAllObjects];
   361 			[parser abortParsing];
   362 		} else {
   363 			//We're still looking for more messages in this file.
   364 			//Pop the current autorelease pool and start a new one.
   365 			//This frees the most recent tree of autoreleased AIXMLElements.
   366 			[parsingAutoreleasePool release];
   367 			parsingAutoreleasePool = [[NSAutoreleasePool alloc] init];
   368 		}
   369 	}
   370 }
   371 
   372 @end