appjam 0.1.0.pre4

data/lib/appjam/generators/Classes/org/puremvc/objectivec/patterns/mediator/Mediator.h

@@ -0,0 +1,35 @@
+//
+//  Mediator.h
+//  PureMVC_ObjectiveC
+//
+//  PureMVC Port to ObjectiveC by Brian Knorr <brian.knorr@puremvc.org>
+//  PureMVC - Copyright(c) 2006-2008 Futurescale, Inc., Some rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "IMediator.h"
+#import "Notifier.h"
+
+/**
+ * A base <code>IMediator</code> implementation. 
+ * 
+ * @see View
+ */
+@interface Mediator : Notifier <IMediator> {
+	NSString *mediatorName;
+	id viewComponent;
+}
+
+@property(nonatomic, retain) id viewComponent;
+@property(nonatomic, retain) NSString *mediatorName;
+
++(id)mediator;
++(id)withMediatorName:(NSString *)mediatorName;
++(id)withMediatorName:(NSString *)mediatorName viewComponent:(id)viewComponent;
++(id)withViewComponent:(id)viewComponent;
+-(id)initWithMediatorName:(NSString *)mediatorName viewComponent:(id)viewComponent;
+-(void)initializeMediator;
+
++(NSString *)NAME;
+
+@end

data/lib/appjam/generators/Classes/org/puremvc/objectivec/patterns/mediator/Mediator.m

@@ -0,0 +1,101 @@
+//
+//  Mediator.m
+//  PureMVC_ObjectiveC
+//
+//  PureMVC Port to ObjectiveC by Brian Knorr <brian.knorr@puremvc.org>
+//  PureMVC - Copyright(c) 2006-2008 Futurescale, Inc., Some rights reserved.
+//
+
+#import "Mediator.h"
+
+@implementation Mediator
+
+@synthesize mediatorName, viewComponent;
+
++(id)mediator {
+	return [[[self alloc] initWithMediatorName:nil viewComponent:nil] autorelease];
+}
+
++(id)withMediatorName:(NSString *)mediatorName {
+	return [[[self alloc] initWithMediatorName:mediatorName viewComponent:nil] autorelease];
+}
+
++(id)withMediatorName:(NSString *)mediatorName viewComponent:(id)viewComponent {
+	return [[[self alloc] initWithMediatorName:mediatorName viewComponent:viewComponent] autorelease];
+}
+
++(id)withViewComponent:(id)viewComponent {
+	return [[[self alloc] initWithMediatorName:nil viewComponent:viewComponent] autorelease];
+}
+
+-(id)initWithMediatorName:(NSString *)_mediatorName viewComponent:(id)_viewComponent {
+	if (self = [super init]) {
+		self.mediatorName = (_mediatorName == nil) ? [[self class] NAME] : _mediatorName;
+		self.viewComponent = _viewComponent;
+		[self initializeMediator];
+	}
+	return self;
+}
+
+/**
+ * The name of the <code>Mediator</code>. 
+ * 
+ * <P>
+ * Typically, a <code>Mediator</code> will be written to serve
+ * one specific control or group controls and so,
+ * will not have a need to be dynamically named.</P>
+ */
++(NSString *)NAME {
+	return @"Mediator";
+}
+
+/**
+ * Initialize the Mediator instance.
+ * 
+ * <P>
+ * Called automatically by the constructor, this
+ * is your opportunity to initialize the Mediator
+ * instance in your subclass without overriding the
+ * constructor.</P>
+ * 
+ * @return void
+ */
+-(void)initializeMediator {}
+
+/**
+ * Handle <code>INotification</code>s.
+ * 
+ * <P>
+ * Typically this will be handled in a switch statement,
+ * with one 'case' entry per <code>INotification</code>
+ * the <code>Mediator</code> is interested in.
+ */
+-(void)handleNotification:(id<INotification>)notification {}
+
+/**
+ * List the <code>INotification</code> names this
+ * <code>Mediator</code> is interested in being notified of.
+ * 
+ * @return Array the list of <code>INotification</code> names 
+ */
+-(NSArray *)listNotificationInterests {
+	return [NSArray array];
+}
+
+/**
+ * Called by the View when the Mediator is registered
+ */ 
+-(void)onRegister {}
+
+/**
+ * Called by the View when the Mediator is removed
+ */ 
+-(void)onRemove {}
+
+-(void)dealloc {
+	self.mediatorName = nil;
+	self.viewComponent = nil;
+	[super dealloc];
+}
+
+@end

data/lib/appjam/generators/Classes/org/puremvc/objectivec/patterns/observer/Notification.h

@@ -0,0 +1,52 @@
+//
+//  Notification.h
+//  PureMVC_ObjectiveC
+//
+//  PureMVC Port to ObjectiveC by Brian Knorr <brian.knorr@puremvc.org>
+//  PureMVC - Copyright(c) 2006-2008 Futurescale, Inc., Some rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "INotification.h"
+
+/**
+ * A base <code>INotification</code> implementation.
+ * 
+ * <P>
+ * PureMVC does not rely upon underlying event models such 
+ * as the one provided with in AppKit or UIKit</P>
+ * 
+ * <P>
+ * The Observer Pattern as implemented within PureMVC exists 
+ * to support event-driven communication between the 
+ * application and the actors of the MVC triad.</P>
+ * 
+ * <P>
+ * Notifications are not meant to be a replacement for Events
+ * in AppKit or UIKit. Generally, <code>IMediator</code> implementors
+ * place event listeners on their view components, which they
+ * then handle in the usual way. This may lead to the broadcast of <code>Notification</code>s to 
+ * trigger <code>ICommand</code>s or to communicate with other <code>IMediators</code>. <code>IProxy</code> and <code>ICommand</code>
+ * instances communicate with each other and <code>IMediator</code>s 
+ * by broadcasting <code>INotification</code>s.</P>
+ * 
+ * @see Observer
+ * 
+ */
+@interface Notification : NSObject <INotification> {
+	NSString *name, *type;
+	id body;
+}
+
+@property(nonatomic, retain) NSString *name;
+@property(nonatomic, retain) NSString *type;
+@property(nonatomic, retain) id body;
+
++(id)withName:(NSString *)name body:(id)body type:(NSString *)type;
++(id)withName:(NSString *)nam;
++(id)withName:(NSString *)name body:(id)body;
++(id)withName:(NSString *)name type:(NSString *)type;
+-(id)initWithName:(NSString *)name body:(id)body type:(NSString *)type;
+-(NSString *)description;
+
+@end

data/lib/appjam/generators/Classes/org/puremvc/objectivec/patterns/observer/Notification.m

@@ -0,0 +1,71 @@
+//
+//  Notification.m
+//  PureMVC_ObjectiveC
+//
+//  PureMVC Port to ObjectiveC by Brian Knorr <brian.knorr@puremvc.org>
+//  PureMVC - Copyright(c) 2006-2008 Futurescale, Inc., Some rights reserved.
+//
+
+#import "Notification.h"
+
+
+@implementation Notification
+
+@synthesize name, body, type;
+
+/**
+ * Static Convienence Constructor. 
+ * 
+ * @param name name of the <code>Notification</code> instance.
+ * @param body the <code>Notification</code> body.
+ * @param type the type of the <code>Notification</code>
+ */
++(id)withName:(NSString *)name body:(id)body type:(NSString *)type {
+	return [[[self alloc] initWithName:name body:body type:type] autorelease];
+}
+
++(id)withName:(NSString *)name {
+	return [[[self alloc] initWithName:name body:nil type:nil] autorelease];
+}
+
++(id)withName:(NSString *)name body:(id)body {
+	return [[[self alloc] initWithName:name body:body type:nil] autorelease];
+}
+
++(id)withName:(NSString *)name type:(NSString *)type {
+	return [[[self alloc] initWithName:name body:nil type:type] autorelease];
+}
+
+/**
+ * Constructor. 
+ * 
+ * @param name name of the <code>Notification</code> instance.
+ * @param body the <code>Notification</code> body.
+ * @param type the type of the <code>Notification</code>
+ */
+-(id)initWithName:(NSString *)_name body:(id)_body type:(NSString *)_type {
+	if (self = [super init]) {
+		self.name = _name;
+		self.body = _body;
+		self.type = _type;
+	}
+	return self;
+}
+
+/**
+ * Get the string representation of the <code>Notification</code> instance.
+ * 
+ * @return the string representation of the <code>Notification</code> instance.
+ */
+-(NSString *)description {
+	return [NSString stringWithFormat:@"Notification Name: %@ \nBody:%@ \nType:%@", name, body, type];
+}
+
+-(void)dealloc {
+	self.name = nil;
+	self.body = nil;
+	self.type = nil;
+	[super dealloc];
+}
+
+@end

data/lib/appjam/generators/Classes/org/puremvc/objectivec/patterns/observer/Notifier.h

@@ -0,0 +1,40 @@
+//
+//  Notifier.h
+//  PureMVC_ObjectiveC
+//
+//  PureMVC Port to ObjectiveC by Brian Knorr <brian.knorr@puremvc.org>
+//  PureMVC - Copyright(c) 2006-2008 Futurescale, Inc., Some rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "INotifier.h"
+#import "IFacade.h"
+
+/**
+ * A Base <code>INotifier</code> implementation.
+ * 
+ * <P>
+ * <code>MacroCommand, Command, Mediator</code> and <code>Proxy</code> 
+ * all have a need to send <code>Notifications</code>. <P>
+ * <P>
+ * The <code>INotifier</code> interface provides a common method called
+ * <code>sendNotification</code> that relieves implementation code of 
+ * the necessity to actually construct <code>Notifications</code>.</P>
+ * 
+ * <P>
+ * The <code>Notifier</code> class, which all of the above mentioned classes
+ * extend, provides an initialized reference to the <code>Facade</code>
+ * Singleton, which is required for the convienience method
+ * for sending <code>Notifications</code>, but also eases implementation as these
+ * classes have frequent <code>Facade</code> interactions and usually require
+ * access to the facade anyway.</P>
+ * 
+ * @see Facade, Mediator, Proxy, SimpleCommand, MacroCommand
+ */
+@interface Notifier : NSObject <INotifier> {
+	id<IFacade> facade;
+}
+
+@property(nonatomic, retain) id<IFacade> facade;
+
+@end

data/lib/appjam/generators/Classes/org/puremvc/objectivec/patterns/observer/Notifier.m

@@ -0,0 +1,54 @@
+//
+//  Notifier.m
+//  PureMVC_ObjectiveC
+//
+//  PureMVC Port to ObjectiveC by Brian Knorr <brian.knorr@puremvc.org>
+//  PureMVC - Copyright(c) 2006-2008 Futurescale, Inc., Some rights reserved.
+//
+
+#import "Notifier.h"
+#import "Facade.h"
+
+@implementation Notifier
+
+@synthesize facade;
+
+-(id)init {
+	if (self = [super init]) {
+		self.facade = [Facade getInstance];
+	}
+	return self;
+}
+
+/**
+ * Create and send an <code>INotification</code>.
+ * 
+ * <P>
+ * Keeps us from having to construct new INotification 
+ * instances in our implementation code.
+ * @param notificationName the name of the notiification to send
+ * @param body the body of the notification
+ * @param type the type of the notification
+ */
+-(void)sendNotification:(NSString *)notificationName body:(id)body type:(NSString *)type {
+	[facade sendNotification:notificationName body:body type:type];
+}
+
+-(void)sendNotification:(NSString *)notificationName {
+	[self sendNotification:notificationName body:nil type:nil];
+}
+
+-(void)sendNotification:(NSString *)notificationName body:(id)body {
+	[self sendNotification:notificationName body:body type:nil];
+}
+
+-(void)sendNotification:(NSString *)notificationName type:(NSString *)type {
+	[self sendNotification:notificationName body:nil type:type];
+}
+
+-(void)dealloc {
+	self.facade = nil;
+	[super dealloc];
+}
+
+@end

data/lib/appjam/generators/Classes/org/puremvc/objectivec/patterns/observer/Observer.h

@@ -0,0 +1,42 @@
+//
+//  Observer.h
+//  PureMVC_ObjectiveC
+//
+//  PureMVC Port to ObjectiveC by Brian Knorr <brian.knorr@puremvc.org>
+//  PureMVC - Copyright(c) 2006-2008 Futurescale, Inc., Some rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "IObserver.h"
+
+/**
+ * A base <code>IObserver</code> implementation.
+ * 
+ * <P> 
+ * An <code>Observer</code> is an object that encapsulates information
+ * about an interested object with a method that should 
+ * be called when a particular <code>INotification</code> is broadcast. </P>
+ * 
+ * <P>
+ * In PureMVC, the <code>Observer</code> class assumes these responsibilities:
+ * <UL>
+ * <LI>Encapsulate the notification (callback) method of the interested object.</LI>
+ * <LI>Encapsulate the notification context (this) of the interested object.</LI>
+ * <LI>Provide methods for setting the notification method and context.</LI>
+ * <LI>Provide a method for notifying the interested object.</LI>
+ * </UL>
+ * 
+ * @see View, Notification
+ */
+@interface Observer : NSObject <IObserver> {
+	SEL notifyMethod;
+	id notifyContext;
+}
+
+@property SEL notifyMethod;
+@property(nonatomic, retain) id notifyContext;
+
++(id)withNotifyMethod:(SEL)notifyMethod notifyContext:(id)notifyContext;
+-(id)initWithNotifyMethod:(SEL)notifyMethod notifyContext:(id)notifyContext;
+
+@end

data/lib/appjam/generators/Classes/org/puremvc/objectivec/patterns/observer/Observer.m

@@ -0,0 +1,67 @@
+//
+//  Observer.m
+//  PureMVC_ObjectiveC
+//
+//  PureMVC Port to ObjectiveC by Brian Knorr <brian.knorr@puremvc.org>
+//  PureMVC - Copyright(c) 2006-2008 Futurescale, Inc., Some rights reserved.
+//
+
+#import "Observer.h"
+
+
+@implementation Observer
+
+@synthesize notifyMethod, notifyContext;
+
+/**
+ * Static Convienence Constructor.
+ */
++(id)withNotifyMethod:(SEL)notifyMethod notifyContext:(id)notifyContext {
+	return [[[self alloc] initWithNotifyMethod:notifyMethod notifyContext:notifyContext] autorelease];
+}
+
+/**
+ * Constructor. 
+ * 
+ * <P>
+ * The notification method on the interested object should take 
+ * one parameter of type <code>INotification</code></P>
+ * 
+ * @param notifyMethod the notification method of the interested object
+ * @param notifyContext the notification context of the interested object
+ */
+-(id)initWithNotifyMethod:(SEL)_notifyMethod notifyContext:(id)_notifyContext {
+	if (self = [super init]) {
+		self.notifyMethod = _notifyMethod;
+		self.notifyContext = _notifyContext;
+	}
+	return self;
+}
+
+/**
+ * Compare an object to the notification context. 
+ * 
+ * @param object the object to compare
+ * @return boolean indicating if the object and the notification context are the same
+ */
+-(BOOL)compareNotifyContext:(id)object {
+	return [object isEqual:notifyContext];
+}
+
+/**
+ * Notify the interested object.
+ * 
+ * @param notification the <code>INotification</code> to pass to the interested object's notification method.
+ */
+-(void)notifyObserver:(id<INotification>)notification {
+	[notifyContext performSelector:notifyMethod withObject:notification];
+}
+
+-(void)dealloc {
+	self.notifyMethod = nil;
+	self.notifyContext = nil;
+	[super dealloc];
+}
+
+
+@end