The document discusses embedding Direct to Web (D2W) functionality into existing WebObjects applications. It explains why one would want to do this, such as to reduce component explosion, provide CRUD functionality, enable property sorting and grouping, and support localization. It covers how to embed D2W, including using the necessary frameworks and resources. It also demonstrates different Apple and WOnder D2W components that can be embedded and provides examples of how to use them, including using bindings and page configurations. Finally, it briefly discusses custom D2W components.

1. MONTREAL 1/3 JULY 2011
Custom and Embedded D2W
Mixing Direct to Web into existing WO apps

2. Dashboard Demo

3. Why?

4. Why?
• Reduce component ‘explosion’

5. Why?
• Reduce component ‘explosion’
• CRUD functionality

6. Why?
• Reduce component ‘explosion’
• CRUD functionality
• Property sorting

7. Why?
• Reduce component ‘explosion’
• CRUD functionality
• Property sorting
• Property grouping

8. Why?
• Reduce component ‘explosion’
• CRUD functionality
• Property sorting
• Property grouping
• Display group management

9. Why?
• Reduce component ‘explosion’
• CRUD functionality
• Property sorting
• Property grouping
• Display group management
• Localization

10. Why?
• Reduce component ‘explosion’
• CRUD functionality
• Property sorting
• Property grouping
• Display group management
• Localization
• ...and more!

11. How?

12. Classpath

13. Classpath
• JavaDirectToWeb.framework

14. Classpath
• JavaDirectToWeb.framework
• JavaDTWGeneration.framework

15. Classpath
• JavaDirectToWeb.framework
• JavaDTWGeneration.framework
• EOProject.framework

16. Classpath
• JavaDirectToWeb.framework
• JavaDTWGeneration.framework
• EOProject.framework
• ERDirectToWeb.framework

17. Classpath
• JavaDirectToWeb.framework
• JavaDTWGeneration.framework
• EOProject.framework
• ERDirectToWeb.framework
• Your favorite ‘Look’ framework

18. Resources

19. Resources
• d2w.d2wmodel

20. Resources
• d2w.d2wmodel
• user.d2wmodel (optional)

21. Resources
• d2w.d2wmodel
• user.d2wmodel (optional)
• Localized.lproj folders (optional)

22. Additional D2W Model Names
• er.directtoweb.ERD2WModel.additionalModelNames=(blah.d2w
model)

23. Code

24. Code
• PageWrapper.wo

25. Code
• PageWrapper.wo
• ERD2WDirectAction subclass (recommended)

26. Code
• PageWrapper.wo
• ERD2WDirectAction subclass (recommended)
• Override allowPageConfiguration()

27. Custom Page Wrapper Name
• 0 : frame = 0 => pageWrapperName =
"MyPageWrapper" [com.webobjects.directtoweb.Assignment]

28. Let’s build one!

29. Embedded D2W

30. What are they?

31. Apple Components

32. Apple Components
• D2WEdit

33. Apple Components
• D2WEdit
• D2WInspect

34. Apple Components
• D2WEdit
• D2WInspect
• D2WList

35. Apple Components
• D2WEdit
• D2WInspect
• D2WList
• D2WQuery

36. Apple Components
• D2WEdit
• D2WInspect
• D2WList
• D2WQuery
• D2WSelect

37. WOnder Components

38. WOnder Components
• D2WPick

39. WOnder Components
• D2WPick
• ERD2WQuery

40. WOnder Components
• D2WPick
• ERD2WQuery
• ERXD2WEditRelationship

41. WOnder Components
• D2WPick
• ERD2WQuery
• ERXD2WEditRelationship
• ERXD2WInspect

42. WOnder Components
• D2WPick
• ERD2WQuery
• ERXD2WEditRelationship
• ERXD2WInspect
• ERXD2WList

43. WOnder Components
• D2WPick
• ERD2WQuery
• ERXD2WEditRelationship
• ERXD2WInspect
• ERXD2WList
• ERXD2WPick

44. WOnder Components
• D2WPick
• ERD2WQuery
• ERXD2WEditRelationship
• ERXD2WInspect
• ERXD2WList
• ERXD2WPick
• ERXD2WSelect

45. When do I use them?

46. How do I use them?

47. Embedded D2W List Bindings
ListMovie: ERXD2WList {
pageConfiguration = "ListMovie";
dataSource = movieDataSource;
displayKeys = "((movieInfo, title, category, rated,
dateReleased, revenue),(voteInfo, voting.numberOfVotes,
voting.runningAverage, castVote))";
}

48. pageConfiguration Format
• Basic format is <Task><EntityName>
• Entity parsed using ERXEOAccessUtilities.entityMatchingString()
• Longest matching entity name wins

49. pageConfigurations: Don’t ...
• Don’t start entity names with keywords found in the rule
system: List, Contact, Tab, Wizard, Compare, Calendar, Group,
etc...
• Don’t use pageConfigurations containing two equal length entity
names: MovieRole, RoleBased => ListMovieRoleBased

50. displayKeys Format

51. displayKeys Format
• Documented! See ERD2WPage javadoc

52. displayKeys Format
• Documented! See ERD2WPage javadoc
• Two formats

53. displayKeys Format
(“[tab1]”, “(sectionA1)”, “prop1”, “prop2”, “(sectionA2)”, “prop3”, “[tab2]”, ... )

54. displayKeys Format
(“[tab1]”, “(sectionA1)”, “prop1”, “prop2”, “(sectionA2)”, “prop3”, “[tab2]”, ... )

55. displayKeys Format
(“[tab1]”, “(sectionA1)”, “prop1”, “prop2”, “(sectionA2)”, “prop3”, “[tab2]”, ... )

56. displayKeys Format
(“[tab1]”, “(sectionA1)”, “prop1”, “prop2”, “(sectionA2)”, “prop3”, “[tab2]”, ... )

57. displayKeys Format
(“[tab1]”, “(sectionA1)”, “prop1”, “prop2”, “(sectionA2)”, “prop3”, “[tab2]”, ... )

58. displayKeys Format
((tab1, (sectionA1, prop1, prop2), (sectionA2, prop3)), (tab2, ...))

59. displayKeys Format
((tab1, (sectionA1, prop1, prop2), (sectionA2, prop3)), (tab2, ...))

60. displayKeys Format
((tab1, (sectionA1, prop1, prop2), (sectionA2, prop3)), (tab2, ...))

61. displayKeys Format
((tab1, (sectionA1, prop1, prop2), (sectionA2, prop3)), (tab2, ...))

62. displayKeys Format
((tab1, (sectionA1, prop1, prop2), (sectionA2, prop3)), (tab2, ...))

63. Embedded D2W Examples

64. ActionPageDelegate

65. ActionPageDelegate
• Binding ‘action’ on an embedded component creates a delegate

66. ActionPageDelegate
• Binding ‘action’ on an embedded component creates a delegate
• nextPageDelegate specified in the rule system is ignored

67. D2W Custom Components

68. What are they?

69. When do I use them?

70. Types of Custom Components

71. Types of Custom Components
• Switches

72. Types of Custom Components
• Switches
• Wrappers

73. Types of Custom Components
• Switches
• Wrappers
• Integrated

74. Switches
• D2WCustomComponent
• D2WCustomQueryComponent

75. Wrappers
• ERD2WEditString
• ERD2WEditToOneRelationship
• ERD2WEditToManyRelationship

76. Integrated
• ERDControllerButton
• ERDEditHTML
• ERDHasChangesMarker

77. Voting Demo

78. Q &A