mirror of
https://github.com/gnustep/libs-gsweb.git
synced 2025-02-24 12:11:18 +00:00
5e0475ee6c
* GSWExtensions/GSWSessionCreationErrorPage.gswc/GSWSessionCreationErrorPage.gswd * GSWExtensions/GNUmakefile * GSWExtensions/GSWSessionRestorationErrorPage.gswc/GSWSessionRestorationErrorPage.gswd * GSWExtensions/GSWExceptionPage.gswc/GSWExceptionPage.gswd use exclamation.png. exclamation.svg is not displayed inline in mozilla due to a bug in mozilla. * GSWExtensions/WebServerResources/exclamation.png * GSWExtensions/WebServerResources/exclamation.svg new file * GSWExtensions/GSWSessionRestorationErrorPage.gswc/GSWSessionRestorationErrorPage.html * GSWExtensions/GSWExceptionPage.gswc/GSWExceptionPage.html better web design * GSWeb/GSWApplication.m -path get path from _resourceManager _resetCache do not call _clearCache, maybe we should trash the _componentDefinitionCache? _finishInitializingSession: make empty, still seems to work +_applicationClass don not use _applicationGSWBundle * GSWeb/GSWResourceManager.h * GSWeb/GSWResourceManager.m major redesign with WO 4.5 docs in mind. * GSWeb/GSWImageButton.m refactor resourceManager code * GSWeb/GSWeb.h remove GSWBundle class * Testing/DynamicElements added Image test. git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/gsweb/trunk@30806 72102866-910b-0410-8b05-ffd578937521
265 lines
8.3 KiB
Objective-C
265 lines
8.3 KiB
Objective-C
/** 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"
|
||
|
||
@interface GSWComponent : GSWElement <NSCopying>
|
||
{
|
||
//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;
|
||
NSMutableDictionary* _validationFailureMessages;
|
||
// }
|
||
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;
|
||
-(GSWElement*)invokeActionForRequest:(GSWRequest*)aRequest
|
||
inContext:(GSWContext*)aContext;
|
||
-(void)takeValuesFromRequest:(GSWRequest*)request
|
||
inContext:(GSWContext*)aContext;
|
||
#if !GSWEB_STRICT
|
||
-(void)setValidationFailureMessage:(NSString*)message
|
||
forElement:(GSWDynamicElement*)element;
|
||
-(NSString*)validationFailureMessageForElement:(GSWDynamicElement*)element;
|
||
-(NSString*)handleValidationExceptionDefault;
|
||
-(BOOL)isValidationFailure;
|
||
-(NSDictionary*)validationFailureMessages;
|
||
-(NSArray*)allValidationFailureMessages;
|
||
#endif
|
||
|
||
/*
|
||
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,...;
|
||
|
||
-(NSString*)_uniqueID;
|
||
|
||
-(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 GSWResourceManager’s 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;
|
||
|
||
+(void)_registerObserver:(id)observer;
|
||
|
||
-(void)validateAPIAssociations;
|
||
@end
|
||
#endif //_GSWComponent_h__
|