Clickpass plugin for Grails, Part 2

Go to Clickpass and create an account. Once in the account, go to the "My Details" tab and check the "Show software developer tools" under "Additional Preferences". There should now be a "developer" tab present, select it and push the "Create new site" button.

1. Register site

• Type in the site name.
• URL: http://localhost:8080/makedo. This is for running a grails app on your own machine named makedo.
• Description and logo are optional.

2. Log users in

• OpenID trust root: http://localhost:8080.
• begin_openid_login: http://localhost:8080/makedo/openid/login?success_controller=
clickpass&success_action=welcome&error_controller=&error_action=. This link is where Clickpass will access, providing the OpenID details, after one has passed the bar that should be in the app.
• Leave the OpenID parameter label alone.
• Submission method: POST.
• SSL is optional.
• Once you have saved the changes, the page will change and display a choice of clickpass bars and the html code for it down below. Copy the html code into _clickpass.gsp.

3. Merge accounts

• begin_add_openid_to_user URL: http://localhost:8080/makedo/clickpass/merge. This is after the authentication and the check whether the OpenID belongs to any user on the database, bringing him to the registration form. If the user selects to login a pre-existing account, the username and password he provides will be sent to this link. If successful the OpenID will be associated with that account.
• user_id label: Username. This is for the login page Clickpass will provide before accessing the URL above. Merely cosmetic.
• Adding the connect bar is optional.

4. Register new signups

• process_openid_registration_url: http://localhost:8080/makedo/clickpass/register. This is after the authentication and the check whether the OpenID belongs to any user on the database, bringing him to the registration form. The user provides information to Clickpass which will be passed along to the link. If successful a new user account with the associated OpenID will be created and saved in your app.
• new_openid_completion_url: http://localhost:8080/makedo/clickpass/welcome. This is for when authentication is successful and all other things have been taken cared of, e.g. registration or merging.
• The others are optional except for the fields. Changes in the fields may require changes in the register method of the Clickpass controller.
• The URL for the registration form should be left for last as it changes due to the fields. Once you're satified and have saved the changes, you can copy and paste the string into urlString in the welcome method of the Clickpass controller.

Aftermath
Once the settings are done, you can use Clickpass.

Clickpass plugin for Grails, Part 1

Clickpass works by handling the OpenID authentication and sending it back to the site. This means that any Grails app using this plugin must also install the OpenID plugin. Also the site will need to be registered with Clickpass and some settings need to be set online. When the authenticated details are sent back, the user is logged in and sent to the welcome page, sent to a form for details to complete registration or asked to login to attach the OpenID to an existing user account.

• grails create-plugin clickpass.
• Add ClickpassController.groovy to grails-app/controller.
• Add User.groovy to grails-app/domain. This is a dummy file required for the plugin to be packaged.
• Add ClickpassTagLib.groovy to grails-app/taglib.
• Add _clickpass.gsp to grails-app/views.
• Add welcome.gsp to grails-app/views/clickpass

ClickpassController.groovy

class ClickpassController {
    def openidService

    def index = { response.sendError(404) }

    def welcome = {
        def user = null
  
 if (openidService.isLoggedIn(session)) {
            user = User.findByOpenid(openidService.getIdentifier(session))
            if (user == null) {
                def urlString = "http://www.clickpass.com/process_new_openid?
                    site_key=Xr2zelexGn&process_openid_registration_url=
                    http%3A%2F%2Flocalhost%3A8080%2Fsocialr%2Fclickpass%2F
                    register&new_openid_completion_url=http%3A%2F%2F
                    localhost%3A8080%2Fsocialr%2Fclickpass%2Fwelcome&
                    requested_fields=nickname%2Cemail&required_fields=&
                    nickname_label=Nickname&email_label=Email"
                redirect(url:urlString)
            }
        }
    }

    def merge = {
        def user = User.findByUsernameAndPassword(params.user_id, params.password)
        def urlredirect = 
            java.net.URLDecoder.decode(params.clickpass_merge_callback_url) + 
            "&userid_authenticated=false"   
      
        if (user == null) {
            redirect(url:urlredirect)
        }

        user.openid = openidService.getIdentifier(session)

        if (user.save()) {           
            redirect(controller:'clickpass',action:'welcome')
        }
        else {
            redirect(url:urlredirect)
        }
    }
  
    def register = {
        def user = new User()
        user.username = params.nickname
        user.email = params.email
        user.openid = openidService.getIdentifier(session)
        user.password = ''
      
        if (user.save()) {
            flash.message = "Thank you for signing up."
            redirect(controller:'clickpass', action:'welcome')
        }
        else {
            flash.message = "There is a problem signing up."
            redirect(controller:'clickpass', action:'index')
        }
    }
}

• index: Nothing for the index to do so set up a 404.
• welcome: When a user is authenticated by OpenID, a search is made to see whether that OpenID is in the database, if not then redirect to the registration page. The urlString is obtained from Clickpass so this needs to be changed for each site
• merge: A user, authenticated by OpenID, who wants to attach the ID to his account.
• register: Create a new user account with the OpenID and save it.

User.groovy
Nothing in it except for the class declaration.

ClickpassTagLib.groovy

class ClickpassTagLib {
    static namespace = "clickpass"
 
    def bar = { attrs, body -> 
        try {
            out << render(template:"/clickpass", contextPath:"${pluginContextPath}")
        }
        catch(Exception e) {
            log.error(e)
        }
    }
}

• The namespace allows one to use it, i.e <clickpass:foobar/>, in the code instead of the generic <g:foobar/>
• For usage in an app, all that is required is <clickpass:bar/> to be inserted into the html.
• The / in the template name is necessary to revert the path to the project base, otherwise it would go looking in the main app views folder.
• The contextPath:"${pluginContextPath}" is not mentioned in the documention but after setting the path to the base, this sets it to the correct plugin views folder.

_clickpass.gsp
The html for this is generated by Clickpass, after registering your site, you can just copy and paste. This creates the Clickpass login bar.

welcome.gsp

<html>
    <head>
        <link rel="openid.server" href="http://www.clickpass.com/openid_server" />
        <link rel="openid.delegate" href="http://clickpass.com/public/iseec" /> 
        <title>Welcome</title>
    </head>
    <body>
        <h1>Welcome</h1>
        <openid:identifier /> 
        <openid:ifLoggedIn>
            <openid:logoutLink>Logout</openid:logoutLink>
        </openid:ifLoggedIn>
    </body>
</html>

• This is a simple welcome page after the user successfully logs in and his account is verified.
• One can replace it with their own or redirect from this page.
• The OpenID is displayed as well as a logout link.

Aftermath

• grails package-plugin to get it all into a zip file.
• grails install-plugin /path/to/plugin/grails-example-0.1.zip to install it into an app.

IPhone MoviePlayer Sample Code 4

MyOverlayView

Interface

Instance methods:

• -(void)awakeFromNib;
• -(void)dealloc;
• -(void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event;

Implementation

Imports:

• #import "MyViewController.h"

-(void)awakeFromNib
Rotate the overlay 90 degrees clockwise then translate it to the centre of the screen. This will match the orientation the movie player uses, full-screen landscape mode.

-(void)dealloc
Call super dealloc.

-(void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event
Similar to the MyImageView implementation. This creates a OverlayViewTouchNotification and fires it off.

IPhone MoviePlayer Sample Code 3

MyImageView

Interface

Imports:

• #import "MyViewController.h"

Instance variables:

• mViewController

Instance methods:

• -(void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event;

Implementation

-(void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event
Receives a set with the touches and the event. Gets a UITouch from the set and check it's phase. If it's UITouchPhaseBegan, play the movie.

IPhone MoviePlayer Sample Code 2

MyViewController

Interface

Imports:

• #import < MediaPlayer/MediaPlayer.h >
• #import "MyOverlayView.h"

The line 'extern NSString * const OverlayViewTouchNotification' creates a global constant that will be used for touches to the overlay view. Any class importing MyViewController can access this variable.

Instance variables:

• mMoviePlayer (MPMoviePlayerController)
• mMovieURL (NSURL)
• mOverlayView (MyOverlayView)

Instance methods:

• -(NSURL *)movieURL;
• -(void)initMoviePlayer;
• -(IBAction)playMovie:(id)sender;
• -(void)overlayViewTouches:(NSNotification *)notification;
• -(IBAction)overlayViewButtonPress:(id)sender;

Implementation

Imports:

• #import "MoviePlayerAppDelegate.h"

Initialise constant OverlayViewTouchNotification with the string 'overlayViewTouch'.

#pragma is a compiler directive. However the compiler ignores it if #pragma mark is used. #pragma mark helps with the organisation of your methods in the Xcode dropdown list.

'#pragma mark -' divvies up the methods by creating a spacer line while '#pragma mark Movie Player Routines' creates a bold label with the text 'Movie Player Routines'.

Movie Player Routines
- (void) moviePreloadDidFinish:(NSNotification*)notification
- (void) moviePlayBackDidFinish:(NSNotification*)notification
- (void) movieScalingModeDidChange:(NSNotification*)notification
These are events. When they are triggered is evident from the names. There is no code inside them.

-(void)initMoviePlayer

• Register MPMoviePlayerContentPreloadDidFinishNotification (named after the definition in MPMoviePlayerController.h) with NSNotificationCenter.
• The movie player object, mMoviePlayer, is created by allocating MPMoviePlayerController and initialising it with movieURL.
• Register MPMoviePlayerPlaybackDidFinishNotification and MPMoviePlayerScalingModeDidChangeNotification, giving mMoviePlayer as the notification sender.
• Obtain the MoviePlayerAppDelegate object and use its instance variables to set mMoviePlayer.
• Register OverlayViewTouchNotification.

-(IBAction)playMovie:(id)sender

• Play mMoviePlayer.
• Get the application windows in an array.
• Get the movie player window.
• Add mOverlayView as the subview of the movie player window.

View Controller Routines
-(NSURL *)movieURL

• Check mMovieURL whether it's null or not.
• Passing will return mMovieURL.
• Failing will get the main bundle, look for 'Movie.m4v', check it and convert the path to NSURL before assigning it to movieURL.

-(BOOL)shouldAutorotateToInterfaceOrientation:(UIInterfaceOrientation) interfaceOrientation
-(void)didReceiveMemoryWarning
-(void)overlayViewTouches:(NSNotification *)notification
-(IBAction)overlayViewButtonPress:(id)sender
Trivial or empty methods.

-(void)dealloc
Remove all registered notifications and release the movie player.

IPhone MoviePlayer Sample Code

Deconstructing the MoviePlayer app to see how the Media Player Framework ticks.

MoviePlayer has 4 classes:

• MoviePlayerAppDelegate
• MyImageView
• MyOverlayView
• MyViewController

A new IPhone application automatically creates 2 classes, with project name MPC, MPCAppDelegate and MPCViewController. Therefore, MyImageView and MyOverlayView are additions while MyViewController has been renamed.

MoviePlayerAppDelegate

Interface

There are 2 different ways of including a file/class:

• #import "MyViewController.h"
• @class MyViewController;

The interface lists 3 instance variables of type NSInteger aside from the default UIWindow and ViewController:

• backgroundColor
• controlMode
• scalingMode

The @property declares the accessor methods for the 5 variables. It has attributes which modify the accessors.

Example: @property (nonatomic, retain) UIWindow *window;

nonatomic means the accessor returns the value directly, the default is to lock, get value, unlock which is meant for multithreaded environments.

assign, retain or copy must be explicitly set if garbage collection is not used. assign is the default and means the setter uses a simple assignment. retain keeps the object variable in-memory and cannot be deallocated without your permission. copy means that a copy of the object should be used for assignment and the previous one is sent a release message.

3 instance methods:

• -(void)setUserSettingsDefaults;
• -(void)applicationDidFinishLaunching:(UIApplication *)application;
• -(void)dealloc;

Implementation

3 NSString keys:

• kScalingModeKey = @"scalingMode"
• kControlModeKey = @"controlMode"
• kBackgroundColorKey = @"backgroundColor"

@synthesize generates the accessors according to the attributes listed. If implemented manually, the code must follow what has been specified in the @property. @synthesize will only generate accessors that don't exist so if a variable has a setter already, then only a getter will be generated.

-(void)setUserSettingsDefaults
Sets up a test calling NSUserDefaults to see if there's a match. Passing will set the scalingMode, controlMode and backgroundColor variables. Failing will create the values based on the settings bundle info and then set the variables:

• Get the path to the main bundle of the project.
• Append Settings.bundle to the path using stringByAppendingPathComponent, which takes care of adding separators.
• Append Root.plist to the path, same as before.
• Create a dictionary using dictionaryWithContentsOfFile, giving the path to Root.plist.
• Create the prefSpecifierArray array from the dictionary using the key, PreferenceSpecifiers, which is a tag in Root.plist.
  • Root.plist is an XML file with dict, array and key tags. May be an easy way to read XML.
• Declare 3 NSNumber variables and a dictionary, prefItem.
• Loop prefSpecifierArray with the current value going into prefItem.
• Set keyValueStr with the dictionary using the key, 'Key'.
• Set defaultValue with the dictionary using the key, 'DefaultValue'.
• Check if keyValueStr is equal to any NSStrings specified above.
• Set the numbers with defaultValue if any is correct.
• Create a dictionary containing the default values and their keys.
• Register the dictionary with NSUserDefaults using registerDefaults.
• Updates and writes to the persistent domains using synchronize.

-(void)applicationDidFinishLaunching:(UIApplication *)application
Add the ViewController's view as a subview of the UIWindow. Call self with setUserSettingsDefaults to get the default movie player settings. Lastly, call the ViewController with initMoviePlayer to create a movie player object.

-(void)dealloc
Release the UIWindow and the ViewController. Call the super's dealloc method.

Objective-C Classes

Objective-C (Obj-C) is C with Object Oriented Programming tacked on. The object syntax takes some time to get used to, as it is decidedly different from the normal C++/Java syntax.

There are two parts for an object in Obj-C, which are the interface and the implementation. The parts should be stored separately, the interface in a header file (*.h) and the implementation is a *.m file.

The interface stores the instance variables and the prototypes for the class and instance methods. The implementation defines those methods.

Sample code:

*** CounterController.h ***
#import < Cocoa/Cocoa.h >
@interface CounterController : NSObject {
IBOutlet id display_update;
int count;
}
- (IBAction)minus_button_pushed:(id)sender;
- (IBAction)p10_button_pushed:(id)sender;
- (IBAction)plus_button_pushed:(id)sender;
@end

*** CounterController.m ***
#import "CounterController.h"
@implementation CounterController
- (IBAction)minus_button_pushed:(id)sender {
count--;
[display_update setIntValue:count];
}
- (IBAction)p10_button_pushed:(id)sender {
count+=10;
[display_update setIntValue:count];
}
- (IBAction)plus_button_pushed:(id)sender {
count++;
[display_update setIntValue:count];
}
@end

Things of note:

• Obj-C uses import instead of include.
• The class CounterController is a subclass of NSObject.
• Inside the brackets are the instance variables display_update and count.
• The IBOutlet before display_update means the display_update is an output on the GUI display in the Interface Builder.
• id is a general type, meaning any object.
• (IBAction)minus_button_pushed:(id)sender translates to IBAction minus_button_pushed(id sender).
• The - before the methods classify them as instance methods, + for class methods.
• The brackets [] indicate messaging, [display_update setIntValue:count] translates to display_update.setIntValue(count).

http://www.gmonline.demon.co.uk/cscene/CS7/CS7-05.html
http://en.wikipedia.org/wiki/Objective-C
http://www.otierney.net/objective-c.html