Declarative mechanism for defining a hierarchy of objects

• US 20040230900A1
• Filed: 05/16/2003
• Published: 11/18/2004
• Est. Priority Date: 05/16/2003
• Status: Active Grant

• Current Assignee: Microsoft Technology Licensing LLC (Microsoft Corporation)
• Original Assignee: Microsoft Corporation
• Inventors: Relyea, Robert A., King, Joseph, Bogdan, Jeff, Wilson, Chris, Grambihler, Roger
• Granted Patent: US 7,331,014 B2
• Time in Patent Office: Days
• US Class Current: 715/513
• CPC Class Codes: G06F 9/4493 Object persistence
• CPC Class Codes: G06F 9/451 Execution arrangements for user interfaces

Abstract

Described is a method and data structure that enables an object to be specified declaratively within a markup document. The markup document may be XML-based. In accordance with the invention, the object is written based on a mapping. The mapping includes a URL attribute for defining a location for a definition file having assemblies and namespaces where classes are specified. The class name is mapped to the markup document as a tag name. Properties and events of a class are mapped to attributes of the tag associated with the class. The method further includes a method to parse the markup language to create a hierarchy of objects. Attributes that do not map directly to a class are defined with a definition tag. The definition tag is also used to add programming code to a page.

Claims

1. A method to determine a hierarchy of objects from an extensible language markup file having a root tag comprising the steps of:

determining a namespace definition file from an xmlns attribute in one of the root tag and a mapping tag, the namespace definition file having a list comprising at least one assembly and at least one namespace;

for each tag in the markup language file;

mapping a name of the tag to a class in the at least one namespace;

if the tag has an attribute;

mapping the attribute to one of one of a property and an event associated with the class and one of another property and another event associated with another class.

2. The method of claim 1 further comprising the step of instantiating an object of the class.

3. The method of claim 1 wherein the step of mapping the name of the tag to the class includes the step of searching for the name of the tag in the at least one namespace.

4. The method of claim 1 wherein the step of mapping the name of the tag to the class includes mapping the name of the tag to one of the class and the property.

5. The method of claim 1 wherein the attribute has an attribute name, the step of mapping the attribute to one of a property and an event associated with the class comprises the steps of:

searching for the attribute name in a property section of the class; and

searching for the attribute name in an event section of the class if the attribute name is not in the property section of the class.

6. The method of claim 1 further comprising the steps of:

if the name of the tag has a first section and a second section separated by a period;

identifying the tag as an attribute wherein the first section is a class name and the second section is an attribute name indicating one of a property and an event;

searching for the class name in the at least one namespace;

searching for the second section in one of a property section and an event section of the class name in the at least namespace; and

calling a type converter to convert a string of the tag to an object and set a value of the one of the property and the event.

7. The method of claim 1 wherein the one of the property and the event is the property, the method further comprising the steps of:

calling a type converter for the property being set if the attribute is a text string;

if the attribute is an other tag;

locating the class based on the other tag'"'"'s name;

instantiating an object of the class based on the other tag'"'"'s name; and

setting the object as a value of the property on the tag.

8. The method of claim 1 further comprising the step of using a predefined meaning for the tag if the tag is a definition tag.

9. The method of claim 8 wherein the step of using a predefined meaning for the tag includes parsing programming code if the tag is a code tag.

10. The method of claim 1 further comprising the step of:

if the attribute is a compound property having a text string as a value;

calling a type converter to convert the text string to an object; and

setting the object as the value of the property.

11. The method of claim 1 further comprising the step of:

if the attribute is a compound property having an object as a value;

creating an instance of the object; and

setting the object as the value of the property.

12. The method of claim 1 further comprising the steps of:

instantiating an object of the class;

querying the object to see if the object implements an IApplyValue interface;

calling an Object.ApplyValue with an elementReference and a BackgroundPropertyID as values if the object implements an IApplyValue interface; and

setting a property of an attribute to the object if the object does not support the IApplyValue interface.

13. The method of claim 1 further comprising the steps of:

instantiating an object of the class;

if the object implements IliteralContent, passing content in the tag for the object to the object without parsing the text.

14. The method of claim 1 wherein the xmlns attribute has a link specifying a location of a resource directory, the method further comprising the steps of:

fetching the namespace definition file from the resource directory; and

storing the namespace definition file locally.

15. The method of claim 1 wherein the root tag is a tag indicating the extensible language markup file is a file specifying a fixed-format document, the method further comprising the step of creating a fixed-format document using classes in the at least one namespace.

16. The method of claim 15 wherein the step of creating a fixed-format document includes the steps of instantiating at least one fixed page, the at least one fixed page having one of a text element, a vector graphic element, and an image.

17. The method of claim 1 wherein the root tag is a tag indicating the extensible language markup file is a file specifying an adaptive-flow document, the method further comprising the step of specifying an adaptive-flow document using tags mapped to classes in the at least one namespace.

18. The method of claim 17 wherein the step of specifying an adaptive-flow document includes the steps of specifying a tag having an attribute associated with at least one of a text size and positioning property, a strength of the column property, a display property, an emphasis property, and a source property.

19. The method of claim 1 wherein the root tag is a tag indicating the extensible language markup file is a file specifying a user interface, the method further comprising the step of creating the user interface using classes in the at least one namespace.

20. A computer-readable medium having stored thereon a markup language data structure, comprising:

a first field containing data mapped to a programming language class; and

a second data field containing data mapped to one of a property and an event in the class.

21. The computer-readable medium of claim 20 further comprising a third field containing data indicating a uniform resource locator for retrieving a definition file having at least one assembly and at least one namespace for interpreting the first field and the second field.

22. The computer-readable medium of claim 20 wherein if the second data field has a * character, the second data field is set to a value equal to one of a newly instantiated object and an existing referenced object during process of the data structure.

23. The computer-readable medium of claim 20 wherein the second data field has stored thereon a compound property and wherein upon processing the second data field, a type converter is called if the second field is a text string.

24. The computer-readable medium of claim 23 wherein upon processing the second data field, if the second field is an other tag, a class based on the other tag'"'"'s name is located, an object of the class based on the other tag'"'"'s name is instantiated, and the object is set as a value of a property on the tag.

25. A computer-readable medium having computer-executable instructions for determining a hierarchy of objects from an extensible language markup file having a root tag, the computer-executable instructions for performing the steps comprising:

determining a namespace definition file from an xmlns attribute in one of the root tag and a mapping tag, the namespace definition file having a list comprising at least one assembly and at least one namespace;

for each tag in the markup language file;

mapping a name of the tag to a class in the at least one namespace;

if the tag has an attribute;

mapping the attribute to one of one of a property and an event associated with the class and one of another property and another event associated with another class.

26. The computer-readable medium of claim 25 having further computer-executable instructions for performing the step comprising of instantiating an object of the class.

27. The computer-readable medium of claim 25 wherein the step of mapping the name of the tag to the class includes the step of searching for the name of the tag in the at least one namespace.

28. The computer-readable medium of claim 25 wherein the step of mapping the name of the tag to the class includes mapping the name of the tag to one of the class and the property.

29. The computer-readable medium of claim 25 wherein the attribute has an attribute name, the step of mapping the attribute to one of a property and an event associated with the class comprises the steps of:

searching for the attribute name in a property section of the class; and

searching for the attribute name in an event section of the class if the attribute name is not in the property section of the class.

30. The computer-readable medium of claim 25 having further computer-executable instructions for performing the steps comprising of:

if the name of the tag has a first section and a second section separated by a period;

identifying the tag as an attribute wherein the first section is a class name and the second section is an attribute name indicating one of a property and an event;

searching for the class name in the at least one namespace;

searching for the second section in one of a property section and an event section of the class name in the at least namespace; and

calling a type converter to convert a string of the tag to an object and set a value of the one of the property and the event.

31. The computer-readable medium of claim 25 wherein the one of the property and the event is the property, the computer-readable medium having further computer-executable instructions for performing the steps comprising of:

calling a type converter for the property being set if the attribute is a text string;

if the attribute is an other tag;

locating the class based on the other tag'"'"'s name;

instantiating an object of the class based on the other tag'"'"'s name; and

setting the object as a value of the property on the tag.

32. The computer-readable medium of claim 25 having further computer-executable instructions for performing the step comprising of using a predefined meaning for the tag if the tag is a definition tag.

33. The computer-readable medium of claim 32 wherein the step of using a predefined meaning for the tag includes parsing programming code if the tag is a code tag.

34. The computer-readable medium of claim 25 having further computer-executable instructions for performing the step comprising of:

if the attribute is a compound property having a text string as a value;

calling a type converter to convert the text string to an object; and

setting the object as the value of the property.

35. The computer-readable medium of claim 25 having further computer-executable instructions for performing the step comprising of:

if the attribute is a compound property having an object as a value;

creating an instance of the object; and

setting the object as the value of the property.

36. The computer-readable medium of claim 25 having further computer-executable instructions for performing the steps comprising of:

instantiating an object of the class;

querying the object to see if the object implements an IApplyValue interface;

calling an Object.ApplyValue with an elementReference and a BackgroundPropertyID as values if the object implements an IApplyValue interface; and

setting a property of an attribute to the object if the object does not support the IApplyValue interface.

37. The computer-readable medium of claim 25 having further computer-executable instructions for performing the steps comprising of:

instantiating an object of the class;

if the object implements ILiteralContent, passing content in the tag for the object to the object without parsing the text.

38. The computer-readable medium of claim 25 wherein the xmlns attribute has a link specifying a location of a resource directory, the method further comprising the steps of:

fetching the namespace definition file from the resource directory; and

storing the namespace definition file locally.

39. The computer-readable medium of claim 25 wherein the root tag is a tag indicating the extensible language markup file is a file specifying a fixed format document, the method further comprising the step of creating a fixed format document using classes in the at least one namespace.

40. The computer-readable medium of claim 39 wherein the step of creating a fixed format document includes the steps of instantiating at least one fixed page, the at least one fixed page having one of a text element, a vector graphic element, and an image.

41. The computer-readable medium of claim 25 wherein the root tag is a tag indicating the extensible language markup file is a file specifying an adaptive flow document, the method further comprising the step of specifying an adaptive flow document using tags mapped to classes in the at least one namespace.

42. The computer-readable medium of claim 41 wherein the step of specifying an adaptive-flow document includes the steps of specifying a tag having an attribute associated with at least one of a text size, a text line spacing, an image size, an image placement, margins, gutters, and a width and number of columns.

43. A method to declaratively define an object comprising the steps of:

mapping an uniform resource locator (URL) for a location of a definition file to an xmlns attribute in one of a root tag and a mapping tag, the definition file having at least one namespace;

setting a tag name to a class name in the at least one namespace;

setting an attribute of the tag to a property name if the object has a property setting.

44. The method of claim 43 further comprising the step of setting the attribute of the tag to an event name if the object has an event defined.

45. The method of claim 43 further comprising the step of defining a definition tag to add one of programming code into a page and resources.

46. The method of claim 43 wherein the step of defining a definition tag to add one of the programming code into the page and the resources comprises setting a def:

Code element to add the programming code into the page.

47. The method of claim 43 further comprising the step of defining a definition tag to add an attribute that is not associated with a class.

48. The method of claim 47 wherein the step of defining a definition tag to add an attribute that is not associated with a class comprises setting a def:

Language attribute to specify a language used to compile code.

49. The method of claim 43 further comprising the step of representing an attribute as a first section and a second sections separated by a period, the first section set to a class name corresponding to the class in which one of the property and an event is defined and the second section set to a name of the one of the property and the event.