WOTopics (Re: We need a WOCookbook!

[David Neumann <dneumann@apple.com>]

Note that Programming Topics have been online since WO4 came out:

http://developer.apple.com/techpubs/webobjects/System/Documentation/Developer/WebObjects/Topics/TopicsTOC.html

This link is accessible off the main WO docs page:
http://developer.apple.com/techpubs/webobjects/webobjects.html

d

Christopher Wolf wrote:
> 
> In WO 4.0.1 (now shipping with Mac OS X server :-) there is a
> "Programming Topics" section of the documentation
> (/System/Documentation/Developer/Topics) which gives you cookbook
> style answers to many common questions.   This is a really nice start
> and hopefully will continue to be updated and improved (and perhaps
> made available on the web).
> 
> Here's the T.O.C:
> 
> WebObjects Programming Topics
> 
> Handling Errors
> · Understanding the Default WebObjects Error Page
> · Customizing the Default Error Behavior
> · Detecting Freed Object Exceptions
> 
> Performance Tuning
> · Detecting Memory Leaks
> · Batch Faulting to Improve Performance
> · Prefetching
> 
> Programming Language Considerations
> · Mixing Languages in an Application
> 
> Localizing Your Application
> · Handling International Character Sets with EOF
> 
> Implementing Security
> · Implementing a Login Panel
> 
> Web Application Considerations
> · Generating a Static Site
> · Providing for File Uploads
> · Sending E-mail from a WebObjects Application
> · Displaying Images Stored in a Database
> · Dealing with Browser Backtracking
> 
> Extending WebObjects
> · Extending Dynamic Elements
> 
> Designing Enterprise Objects
> · Working with Unnormalized Tables
> 
> Fetching
> · Batch Faulting to Improve Performance
> · Fetching Distinct Results
> · Fetching with an Editing Context
> · Creating Sort Orderings
> · Prefetching
> · Refreshing Data by Refetching from the Database or Invalidating an
> Object
> 
> Inserting, Updating, and Deleting
> · Assigning Default Values to Enterprise Objects
> · Creating a New Enterprise Object
> · Generating Primary Key Values
> · Inserting with the Adaptor Level
> · Deleting with the Adaptor Level
> · Propagating Deletions Across Relationships
> · Updating with the Adaptor Level
> · Detecting Changed Attributes
> · Choosing an Approach for Locking
> · Locking on a Column
> · Optimistic Locking
> · Pessimistic Locking
> · Pessimistic Locking in Oracle
> · Pessimistic Locking in Sybase
> 
> Programming with the Enterprise Objects Adaptor Level
> · When to Choose the Adaptor Level to Improve Performance
> · Deleting with the Adaptor Level
> · Inserting with the Adaptor Level
> · Executing Arbitrary SQL Statements
> · Updating with the Adaptor Level
> 
> Managing the Object Graph
> · Accessing Non-Class Property Values
> · Refreshing Data by Refetching from the Database or Invalidating an
> Object
> · Invalidating Objects
> · When to Revert or Undo in an Editing Context
> 
> Working with Enterprise Objects Framework Objects
> · Setting the Delegates of Database Contexts and Adaptor Contexts
> · Using Nested Editing Contexts
> . Integrating Oracle Context
> 
> WO 4.0.1 ships w> From: matt kangas <kangas@kangas.org>
> > Date: 1999-03-17 02:04:58 -0500
> > To: Multiple recipients of list <webobjects@omnigroup.com>
> > Subject: We need a WOCookbook!
> > X-UIDL: 1867a16a53356f315724f67f3af9643d
> > X-Listprocessor-Version: 6.0 -- ListProcessor by Anastasios Kotsikonas
> > Originator: webobjects@omnigroup.com
> > X-Comment: To unsubscribe, follow directions at
> > http://www.omnigroup.com/MailArchive/
> >
> > (foreword: yup, this should go in webobjects-talk when it's available.
> > This is an opinion on how Apple could improve its WO documentation.)
> >
> > What WebObjects needs is not another manual, or another FAQ... what it
> > needs is a good cookbook! aka a patterns book. (but "cookbook"
> sounds so
> > much friendlier :)
> >
> >
> > Allow me to elaborate...
> >
> > I just spent the evening pondering a component-nesting issue
> that's been
> > bugging me for several months now. I've known all this time that
> I'm going
> > about this in a bass-ackwards fashion in one of my programs, yet a
> > functional and elegant solution has always eluded me. But tonight I
> > started thinking about this again, writing down the exact things I
> want to
> > accomplish with this and going over the WO dev guide & "What's new
> in WO4"
> > doc with a fine-tooth comb. In the end I realized that the
> > "carat notation" for non-sync components is all I really need for this.
> >
> > Or today I replied to Patrick Robinson's question on this forum, but it
> > seems he has a more general issue:
> >
> > > Date: Tue, 16 Mar 1999 21:29:03 -0500 (EST)
> > > From: Patrick Robinson <pgr@ramandu.ext.vt.edu>
> > > To: matt kangas <kangas@kangas.org>
> > > Subject: Re: how to trim leading and trailing spaces?
> > > ...
> > > I really just want to post-process the user input value.  Maybe a
> > > validator is where this behavior belongs, but I can't believe this
> > > isn't something that's much more commonly done, so that it's readily
> > > available.
> >
> > AFAIK the common thread in these examples is that we're both
> looking for
> > some input on *strategies* and common implementations for resolving a
> > problem based on a set of requirements.
> >
> > An aside: Does the WO documentation suck or does it not? Depends on how
> > you look at it. The WO Dev Guide makes for nice reading, but if
> you have
> > a "How do I?" question the answer is (IMHO) often very hard to find in
> > this book. Often what you really need to look it are the
> Foundation/EOF/WO
> > references, but there is no coaching to this effect... the WO Dev Guide
> > should at have a chapter explaining what kind of Qs are answered by the
> > refs and how to find/navigate them.
> >
> > So, assuming this issue was resolved, there still seems to be a
> great need
> > for an "Ask the Guru" book. Yes, this list is *wonderful* for
> exactly this
> > purpose and trawling the archives is tremendously handy, but it is
> neither
> > a) concise & authorative, nor
> > b) an Apple publication
> >
> > I think lots of people get lost in WO trying to do what seem to be
> "simple
> > things", running into a problem and not having a clue how to solve
> it. I
> > also thing this points to a deficiency in Apple's documentation
> which, if
> > resolved, would help more people grok WO more quickly.
> >
> > Humbly submitted for the betterment of us all...
> >
> > --
> >  \7\3\d\e\k\b\8\u\o\x\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \
> \ \ \
> > \m\a\t\t\.\k\a\n\g\a\s\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \
> > m\a\t\t\@\k\a\n\g\a\s\.\o\r\g\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \
> >
> >