see ChangeLog

Monotone-Revision: 9054022ef1ca8aeba6e34842d27d9b94ce002b89

Monotone-Author: dev-unix.inverse.qc.ca
Monotone-Date: 2006-06-15T19:34:10
Monotone-Branch: ca.inverse.sogo

UI/Contacts/UIxContactEditorBase.m

@@ -0,0 +1,273 @@
+/*
+  Copyright (C) 2004-2005 SKYRIX Software AG
+
+  This file is part of OpenGroupware.org.
+
+  OGo is free software; you can redistribute it and/or modify it under
+  the terms of the GNU Lesser General Public License as published by the
+  Free Software Foundation; either version 2, or (at your option) any
+  later version.
+
+  OGo 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 Lesser General Public
+  License for more details.
+
+  You should have received a copy of the GNU Lesser General Public
+  License along with OGo; see the file COPYING.  If not, write to the
+  Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA
+  02111-1307, USA.
+*/
+
+#include "UIxContactEditorBase.h"
+#include <Contacts/SOGoContactObject.h>
+#include <Contacts/SOGoContactFolder.h>
+#include "common.h"
+
+@implementation UIxContactEditorBase
+
+- (id)init {
+  if ((self = [super init])) {
+    self->snapshot = [[NSMutableDictionary alloc] initWithCapacity:16];
+  }
+  return self;
+}
+
+- (void)dealloc {
+  [self->snapshot      release];
+  [self->anaisCN      release];
+  [self->errorText     release];
+  [self->contentString release];
+  [super dealloc];
+}
+
+/* accessors */
+
+- (void)setContentString:(NSString *)_cstr {
+  ASSIGNCOPY(self->contentString, _cstr);
+}
+- (NSString *)contentString {
+  return self->contentString;
+}
+
+- (NSString *)contentStringTemplate {
+  return @"{}"; /* empty property list */
+}
+
+- (NSMutableDictionary *)snapshot {
+  return self->snapshot;
+}
+
+- (void)setErrorText:(NSString *)_txt {
+  ASSIGNCOPY(self->errorText, _txt);
+}
+- (NSString *)errorText {
+  return self->errorText;
+}
+
+- (BOOL)hasErrorText {
+  return [self->errorText length] > 0 ? YES : NO;
+}
+
+
+- (void)setAnaisCN:(NSString *)_txt {
+  ASSIGNCOPY(self->anaisCN, _txt);
+}
+- (NSString *)anaisCN {
+  return self->anaisCN;
+}
+
+
+/* load/store content format */
+
+- (void)loadValuesFromContentString:(NSString *)_s {
+  NSDictionary *plist;
+
+  if ([_s hasPrefix:@"BEGIN:VCARD"]) {
+    // TODO: load vCard values
+    [self errorWithFormat:@"Editing of vCard's is not yet supported!"];
+    return;
+  }
+  
+  if ((plist = [_s propertyList]) == nil) {
+    [self errorWithFormat:@"could not parse content string!"];
+    return;
+  }
+  
+  [self->snapshot removeAllObjects];
+  [self->snapshot addEntriesFromDictionary:plist];
+}
+
+- (void)_fixupSnapshot {
+  // TODO: perform sanity checking, eg build CN on demand
+  NSString *cn, *gn, *sn;
+  
+  cn = [self->snapshot objectForKey:@"cn"];
+  gn = [self->snapshot objectForKey:@"givenName"];
+  sn = [self->snapshot objectForKey:@"sn"];
+  
+  if (![sn isNotNull] || [sn length] == 0)
+    sn = nil;
+  if (![cn isNotNull] || [cn length] == 0)
+    cn = nil;
+  
+  if (sn == nil) {
+    if (cn == nil)
+      sn = @"[noname]";
+    else {
+      // TODO: need a better name parser here
+      NSRange r;
+      
+      r = [cn rangeOfString:@" "];
+      sn = (r.length > 0)
+	? [cn substringFromIndex:(r.location + r.length)]
+	: cn;
+    }
+    [self->snapshot setObject:sn forKey:@"sn"];
+  }
+  if ([self->anaisCN length] > 0 )
+    cn = self->anaisCN;
+  else if (sn == nil && gn == nil)
+    cn = @"[noname]";
+  else if (sn == nil)
+    cn = gn;
+  else if (gn == nil)
+    cn = sn;
+  else
+    cn = [[gn stringByAppendingString:@" "] stringByAppendingString:sn];
+  [self->snapshot setObject:cn forKey:@"cn"];
+}
+
+- (void)saveValuesIntoRecord:(NSMutableDictionary *)_record {
+  [self _fixupSnapshot];
+  [_record addEntriesFromDictionary:[self snapshot]];
+}
+
+/* helper */
+
+- (NSString *)_completeURIForMethod:(NSString *)_method {
+  // TODO: this is a DUP of UIxAppointmentEditor
+  NSString *uri;
+  NSRange r;
+    
+  uri = [[[self context] request] uri];
+    
+  /* first: identify query parameters */
+  r = [uri rangeOfString:@"?" options:NSBackwardsSearch];
+  if (r.length > 0)
+    uri = [uri substringToIndex:r.location];
+    
+  /* next: append trailing slash */
+  if (![uri hasSuffix:@"/"])
+    uri = [uri stringByAppendingString:@"/"];
+  
+  /* next: append method */
+  uri = [uri stringByAppendingString:_method];
+    
+  /* next: append query parameters */
+  return [self completeHrefForMethod:uri];
+}
+
+/* actions */
+
+- (BOOL)shouldTakeValuesFromRequest:(WORequest *)_rq inContext:(WOContext*)_c{
+  return YES;
+}
+
+- (id<WOActionResults>)defaultAction {
+  // TODO: very similiar to apt-editor (apt editor would need to use std names
+  NSString *c;
+  
+  /* load iCalendar file */
+  
+  c = [[self clientObject] contentAsString];
+  if ([c length] == 0) /* a new contact */
+    c = [self contentStringTemplate];
+  
+  [self setContentString:c];
+  [self loadValuesFromContentString:c];
+  
+  return self;
+}
+
+- (BOOL)isWriteableClientObject {
+  return [[self clientObject] 
+	        respondsToSelector:@selector(saveContentString:)];
+}
+
+- (NSString *)viewActionName {
+  /* this is overridden in the mail based contacts UI to redirect to tb.edit */
+  return @"";
+}
+- (NSString *)editActionName {
+  /* this is overridden in the mail based contacts UI to redirect to tb.edit */
+  return @"edit";
+}
+
+- (id)saveAction {
+  NSException *ex;
+  NSString *recstr, *uri;
+  id record;
+  
+  if (![self isWriteableClientObject]) {
+    return [NSException exceptionWithHTTPStatus:400 /* Bad Request */
+                        reason:@"method cannot be invoked on "
+                               @"the specified object"];
+  }
+  
+  if ((record = [self contentString]) == nil) {
+    [self setErrorText:@"Missing object content!"]; // localize
+    return self;
+  }
+  record = [[[record propertyList] mutableCopy] autorelease];
+  if (record == nil) {
+    [self setErrorText:@"Invalid property list data ..."]; // localize
+    return self;
+  }
+  
+  [self saveValuesIntoRecord:record];
+  
+  // TODO: directly hacking the content, hm, not so nice or reasonable?
+  recstr = [record description]; // make plist
+  ex = [[self clientObject] saveContentString:recstr];
+  if (ex != nil) {
+    [self setErrorText:[ex reason]];
+    return self;
+  }
+  
+  uri = ([(uri = [self viewActionName]) length] > 0)
+    ? [self viewActionName] : @"..";
+  uri = [self _completeURIForMethod:uri];
+  return [self redirectToLocation:uri];
+}
+
+- (id)testAction {
+  [self logWithFormat:@"test ..."];
+  return self;
+}
+
+- (id)newAction {
+  // TODO: this is almost a DUP of UIxAppointmentEditor
+  /*
+    This method creates a unique ID and redirects to the "edit" method on the
+    new ID.
+    It is actually a folder method and should be defined on the folder.
+    
+    Note: 'clientObject' is the SOGoAppointmentFolder!
+          Update: remember that there are group folders as well.
+  */
+  NSString *uri, *objectId, *nextMethod;
+  
+  objectId = [NSClassFromString(@"SOGoContactFolder") globallyUniqueObjectId];
+  if ([objectId length] == 0) {
+    return [NSException exceptionWithHTTPStatus:500 /* Internal Error */
+			reason:@"could not create a unique ID"];
+  }
+  
+  nextMethod = [NSString stringWithFormat:@"../%@/%@", 
+			   objectId, [self editActionName]];
+  uri = [self _completeURIForMethod:nextMethod];
+  return [self redirectToLocation:uri];
+}
+
+@end /* UIxContactEditorBase */