Class: Ramaze::Helper::UserHelper::Wrapper

Inherits:
BlankSlate
  • Object
show all
Defined in:
lib/ramaze/helper/user.rb

Overview

Wrapper for the ever-present "user" in your application. It wraps around an arbitrary instance and worries about authentication and storing information about the user in the session.

In order to not interfere with the wrapped instance/model we start our methods with an underscore.

Patches and suggestions are highly appreciated.

Instance Attribute Summary (collapse)

Instance Method Summary (collapse)

Constructor Details

- (Wrapper) initialize(model, callback)

Returns a new instance of Wrapper



195
196
197
198
199
# File 'lib/ramaze/helper/user.rb', line 195

def initialize(model, callback)
  @_model, @_callback = model, callback
  @_user = nil
  
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

- (Object) method_missing(meth, *args, &block)

Refer everything not known THINK: This might be quite confusing... should we raise instead?



277
278
279
280
# File 'lib/ramaze/helper/user.rb', line 277

def method_missing(meth, *args, &block)
  return unless _user
  _user.send(meth, *args, &block)
end

Instance Attribute Details

- (Object) _callback

Returns the value of attribute _callback



193
194
195
# File 'lib/ramaze/helper/user.rb', line 193

def _callback
  @_callback
end

- (Object) _model

Returns the value of attribute _model



193
194
195
# File 'lib/ramaze/helper/user.rb', line 193

def _model
  @_model
end

- (Object) _user

Returns the value of attribute _user



193
194
195
# File 'lib/ramaze/helper/user.rb', line 193

def _user
  @_user
end

Instance Method Details

- (true false) _logged_in?

Returns whether the current user is logged in.

Returns:

  • (true false)

    whether the current user is logged in.

See Also:

  • Ramaze::Helper::User#logged_in?

Author:

  • manveru



261
262
263
# File 'lib/ramaze/helper/user.rb', line 261

def _logged_in?
  !!_user
end

- (Ramaze::Helper::User::Wrapper) _login(creds = nil)

Returns wrapped return value from model or callback

Parameters:

  • creds (Hash) (defaults to: nil)

    this hash will be stored in the session on successful login

Returns:

  • (Ramaze::Helper::User::Wrapper)

    wrapped return value from model or callback

See Also:

  • Ramaze::Helper::User#user_login

Author:

  • manveru



209
210
211
212
213
214
215
216
217
218
# File 'lib/ramaze/helper/user.rb', line 209

def (creds = nil)
  if creds
    if @_user = _would_login?(creds)
      Current.session.resid!
      self._persistence = {:credentials => creds}
    end
  elsif persistence = self._persistence
    @_user = _would_login?(persistence[:credentials])
  end
end

- (Object) _logout

See Also:

  • Ramaze::Helper::User#user_logout

Author:

  • manveru



249
250
251
252
253
# File 'lib/ramaze/helper/user.rb', line 249

def _logout
  (_persistence || {}).clear
  Current.request.env['ramaze.helper.user'] = nil
  Current.session.resid!
end

- (Object) _persistence



269
270
271
# File 'lib/ramaze/helper/user.rb', line 269

def _persistence
  Current.session[:USER]
end

- (Object) _persistence=(obj)



265
266
267
# File 'lib/ramaze/helper/user.rb', line 265

def _persistence=(obj)
  Current.session[:USER] = obj
end

- (Boolean) _would_login?(creds)

The callback should return an instance of the user, otherwise it should answer with nil.

This will not actually login, just check whether the credentials would result in a user.

Returns:

  • (Boolean)


227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
# File 'lib/ramaze/helper/user.rb', line 227

def _would_login?(creds)
  return unless creds

  if c = @_callback
    c.call(creds)
  elsif _model.respond_to?(:authenticate)
    _model.authenticate(creds)
  else
    Log.warn(
      "Helper::User has no callback and there is no %p::authenticate" \
        % _model
    )

    nil
  end
end