libs-gsweb/GSWeb/GSWComponent.h
mguesdon 1920a273fd * GSWeb/GSWPopUpButton.m
fix _slowTakeValuesFromRequest:inContext: 
    (convert valueValue before isEqual:)
  replace while loop by a simplier for loop
  respect GNUstep coding standard (curly brackets placement)
  rename variable to make code more understandable
* GSWeb/GSWComponent.m
  respect GNUstep coding standard (curly brackets placement)
  fix validateTakeValue:forKeyPath: (set value if only if different)
  remove non standard and unused methods validation stuff:
    -setValidationFailureMessage:forElement:
    -validationFailureMessageForElement:
    -handleValidationExceptionDefault
    -isValidationFailure
    -validationFailureMessages
    -allValidationFailureMessages
  fix -path 
  remove context -setIsValidate: calls
  remove _uniqueID
  clean code
* GSWeb/GSWComponent.h
  remove _validationFailureMessages
  remove non standard and unused methods validation stuff
  remove _uniqueID
* GSWeb/GSWUtils.[hm]
  remove non standard -isValidationException
  remove -ValidationExceptionRaise*
* GSWeb/GSWContext.[hm]
  remove -setValidate
  remove -isValidate
* GSWeb/GSWApplication.m
  remove context -setIsValidate: calls	



git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/gsweb/trunk@37800 72102866-910b-0410-8b05-ffd578937521
2014-04-17 18:13:47 +00:00

261 lines
8.1 KiB
Objective-C
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/** GSWComponent.h - <title>GSWeb: Class GSWComponent</title>
Copyright (C) 1999-2004 Free Software Foundation, Inc.
Written by: Manuel Guesdon <mguesdon@orange-concept.com>
Date: Jan 1999
$Revision$
$Date$
<abstract></abstract>
This file is part of the GNUstep Web Library.
<license>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library 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
Library General Public License for more details.
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
</license>
**/
// $Id$
#ifndef _GSWComponent_h__
#define _GSWComponent_h__
#include "GSWElement.h"
@class GSWSession;
@class GSWComponentDefinition;
@class GSWAssociation;
@class GSWDynamicElement;
#include "GSWResponse.h"
#include "GSWContext.h"
@interface GSWComponent : GSWElement <NSCopying, GSWActionResults>
{
//TODO ==> private @private
NSString* _name;
NSMutableDictionary* _subComponents;
NSString* _templateName;
GSWElement* _template;
GSWComponentDefinition* _componentDefinition;
GSWComponent* _parent;
NSMutableDictionary* _keyAssociations;
//NSArray* _associationsKeys; replaced by _keyAssociations
//NSArray* _associations;
GSWElement* _childTemplate;
GSWContext* _context;
GSWSession* _session;
//GSWeb Additions {
NSDictionary* _userDictionary;
NSDictionary* _userAssociations;
NSDictionary* _defaultAssociations;
// }
BOOL _isPage;
BOOL _isCachingEnabled;
BOOL _isSynchronized;
};
- (id)initWithContext:(GSWContext *) aContext;
-(NSString*)description;
#if !GSWEB_STRICT
-(NSDictionary*)userDictionary;
-(void)setUserDictionary:(NSDictionary*)userDictionary;
-(NSDictionary*)userAssociations;
-(void)setUserAssociations:(NSDictionary*)userAssociations;
-(GSWAssociation*)userAssociationForKey:(NSString*)key;
-(NSDictionary*)defaultAssociations;
-(void)setDefaultAssociations:(NSDictionary*)defaultAssociations;
-(GSWAssociation*)defaultAssociationForKey:(NSString*)key;
#endif
-(NSString*)frameworkName;
-(NSString*)baseURL;
-(NSString*)name;
-(NSString*)path;
-(BOOL)isCachingEnabled;
-(void)setCachingEnabled:(BOOL)flag;
-(void) _setParent:(GSWComponent*) parent
associations:(NSMutableDictionary *) assocdict
template:(GSWElement*) template;
-(void) pushValuesToParent;
-(void)synchronizeComponentToParent;
-(void)synchronizeParentToComponent;
-(void) pullValuesFromParent;
-(GSWElement*)_childTemplate;
-(GSWElement*) template;
-(GSWComponentDefinition*)_componentDefinition;
-(NSString*)_templateName /*GS_ATTRIB_DEPRECATED*/;
-(NSString*)declarationName;
-(BOOL)_isPage;
-(void)_setIsPage:(BOOL)isPage;
-(void)_setContext:(GSWContext*)aContext;
-(GSWElement*)templateWithName:(NSString*)aName;
-(GSWComponent*)subComponentForElementID:(NSString*)elementId;
// PRIVATE
-(void)_setSubcomponent:(GSWComponent*)component
forElementID:(NSString*)elementId;
//NDFN
-(void)makeParentsPerformSelectorIfPossible:(SEL)aSelector;
-(void)makeParentsPerformSelectorIfPossible:(SEL)aSelector
withObject:(id)object;
-(void)makeParentsPerformSelectorIfPossible:(SEL)aSelector
withObject:(id)object1
withObject:(id)object2;
-(id)makeAParentPerformSelectorIfPossible:(SEL)aSelector;
-(id)makeAParentPerformSelectorIfPossible:(SEL)aSelector
withObject:(id)object;
-(id)makeAParentPerformSelectorIfPossible:(SEL)aSelector
withObject:(id)object1
withObject:(id)object2;
-(void)makeSubComponentsPerformSelectorIfPossible:(SEL)aSelector;
-(void)makeSubComponentsPerformSelectorIfPossible:(SEL)aSelector
withObject:(id)object;
-(void)makeSubComponentsPerformSelectorIfPossible:(SEL)aSelector
withObject:(id)object1
withObject:(id)object2;
-(GSWAssociation*)_associationWithName:(NSString*)parentBindingName;
-(BOOL)hasBinding:(NSString*)parentBindingName;
-(void)setValue:(id)value
forBinding:(NSString*)parentBindingName;
-(id)valueForBinding:(NSString*)parentBindingName;
-(BOOL)synchronizesVariablesWithBindings;
-(BOOL)synchronizesParentToComponentVariablesWithBindings;
//-(BOOL)synchronizesComponentToParentVariablesWithBindings;
-(BOOL) isStateless;
-(void) reset;
-(NSDictionary*)bindingAssociations;
-(void)sleep;
-(void)sleepInContext:(GSWContext*)aContext;
-(void)appendToResponse:(GSWResponse*)aResponse
inContext:(GSWContext*)aContext;
-(id <GSWActionResults>)invokeActionForRequest:(GSWRequest*)aRequest
inContext:(GSWContext*)aContext;
-(void)takeValuesFromRequest:(GSWRequest*)request
inContext:(GSWContext*)aContext;
/*
Makes sure that the receiver is awake in aContext.
Call this method before using a component which was cached in a variable.
*/
-(void)ensureAwakeInContext:(GSWContext*)aContext;
-(void)awake;
// PRIVATE
-(void)_awakeInContext:(GSWContext*)aContext;
- (id<GSWActionResults>)performParentAction:(NSString *)attribute;
-(GSWComponent*)parent;
-(GSWComponent*)topParent;//NDFN
-(NSArray*)parents;//NDFN
-(NSArray*)parentsClasses;//NDFN
-(GSWComponent*)pageWithName:(NSString*)aName;
-(GSWSession*)session;
-(BOOL)hasSession;
-(GSWContext*)context;
-(NSArray*)languages;//NDFN
-(GSWApplication*)application;
-(void) validationFailedWithException:(NSException *)exception
value:(id)value
keyPath:(NSString *)keyPath;
-(void)_debugWithString:(NSString*)string;
-(void)debugWithFormat:(NSString*)format,...;
-(void)logString:(NSString*)aString;
-(void)logWithFormat:(NSString*)format,...;
-(void)logWithFormat:(NSString*)format
arguments:(va_list)argList;
+(void)logWithFormat:(NSString*)format,...;
-(GSWResponse*)_generateResponseInContext:(GSWContext*)aContext;
-(NSException*)validateValue:(id*)valuePtr
forKey:(NSString*)key;
/**
* This method is called to validate and potentially coerce
* VALUE for the receivers key path. This method also assigns
* the value if it is different from the current value.
* This method will raise an EOValidationException
* if validateValue:forKeyPath:error: returns an error.
* This method returns new value.
**/
- (id)validateTakeValue:(id)value forKeyPath:(NSString *)path;
//+(id)validateValue:(id*)valuePtr
// forKey:(id)key;
-(NSString*)urlForResourceNamed:(NSString*)aName
ofType:(NSString*)extension /*GS_ATTRIB_DEPRECATED*/;
/*
Deprecated in WO 4.0.
Use GSWResourceManagers implementation of
pathForResourceNamed:inFramework:languages:
instead.
*/
-(NSString*)pathForResourceNamed:(NSString*)aName
ofType:(NSString*)extension /*GS_ATTRIB_DEPRECATED*/;
+(GSWElement*)templateWithHTMLString:(NSString*)htmlString
declarationString:(NSString*)declarationString
languages:(NSArray*)languages;
/*
Deprecated in WO 4.0.
Use
templateWithHTMLString:declarationString:languages:
instead.
*/
+(GSWElement*)templateWithHTMLString:(NSString *)htmlString
declarationString:(NSString*)declarationString /*GS_ATTRIB_DEPRECATED*/;
- (GSWResponse*)generateResponse;
-(NSString*)descriptionForResponse:(GSWResponse*)response
inContext:(GSWContext*)aContext;
/*
* the current default returns WOHTML401Markup
* override this in your page component for diffent
* behaviour.
*/
- (WOMarkupType) markupType;
+(void)_registerObserver:(id)observer;
@end
#endif //_GSWComponent_h__