Dan Wood: The Eponymous Weblog (Archives)
Dan Wood is co-owner of Karelia Software, creating programs for the Macintosh computer. He is the father of two kids, lives in the Bay Area of California USA, and prefers bicycles to cars. This site is his older weblog, which mostly covers geeky topics like Macs and Mac Programming. Go visit the current blog here.
Useful Tidbits and Egotistical Musings from Dan Wood
Categories: Business · Mac OS X · Cocoa Programming · General · All Categories
Calendar
| Sun | Mon | Tue | Wed | Thu | Fri | Sat |
|---|---|---|---|---|---|---|
| 1 | 2 | 3 | 4 | |||
| 5 | 6 | 7 | 8 | 9 | 10 | 11 |
| 12 | 13 | 14 | 15 | 16 | 17 | 18 |
| 19 | 20 | 21 | 22 | 23 | 24 | 25 |
| 26 | 27 | 28 | 29 | 30 | 31 |
My Amazon WishList
Subscribe:
Also on this website A Basic Course in Dvorak · The Pickle Machine · The Mentos Gallery · Cocoa Table Tester · Making your Wedding Make a Difference ·
Sites I also work on BikeAlameda · A Progressive Alamedan (my political blog) · Karelia Software
I'm also here: danwood on Twitter
Source Code Organization
permanent link
· Topic/Cocoa
Justin "Carpe Aqua" Williams reveals, on his Pinup CalendarBlog , his technique for organizing source code. I thought I'd link to it, since it's useful and very close to what we do. I don't have a strict template I follow (perhaps I should) but his approach is pretty close.
Some additions I'd suggest would be accessors (getters and setters; his "accessors & mutators" could be split up maybe), public methods (general functionality documented in the header file), and private methods or support methods, special functions not exposed to the outside world.
If you have lots of different kinds of delegate methods, you can always split up any of your categories into sub-categories (e.g. TextField delegate, Window Delegate, data source, etc. For a subcategory, you could forgo #pragma mark - to make the subcategory stand out less in the popup.
If you have a class that is really huge, it's actually helpful to split it up into multiple files. One ".h" file, declaring multiple categories, with the implementation of each category defined in separate files. For example, our document window controller subclass is so big, it merits nine files!
- KTDocWindowController.m (general methods)
- KTDocWindowController+Accessors.m
- KTDocWindowController+ModalOperation.m
- KTDocWindowController+Pasteboard.m
- KTDocWindowController+SiteOutline.m
- KTDocWindowController+SplitView.m
- KTDocWindowController+Toolbar.m
- KTDocWindowController+WebView.m
- KTDocWindowController+WebEditing.m
A final hint: define a macro "mark" to insert the two pragma-mark lines, using Completion Dictionary.