Declarative mechanism for defining a hierarchy of objects

• US 7,331,014 B2
• Filed: 05/16/2003
• Issued: 02/12/2008
• Est. Priority Date: 05/16/2003
• Status: Expired due to Fees

• Current Assignee: Microsoft Technology Licensing LLC (Microsoft Corporation)
• Original Assignee: Microsoft Corporation
• Inventors: Bogdan, Jeff, Wilson, Chris, Relyea, Robert A., King, Joseph, Grambihler, Roger
• Primary Examiner(s): Herdon; Heather R.
• Assistant Examiner(s): Tran; Quoc A.
• Application Number:
  US10/439,505
• Publication Number:
  US 20040230900A1
• Time in Patent Office: 1,733 Days
• Field of Search: 715/514, 715/500, 715/513, 715/524, 715/501.01, 707/103.R, 707/1
• US Class Current: 715/713
• 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 common language runtime (CLR) objects from an extensible language markup file having a root tag for creating a document and implemented at least in part by a machine 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 (a) one of a property and an event associated with the class and (b) one of another property and another event associated with another class, wherein the (a) one of a property and an event associated with the class and the (b) one of another property and another event associated with another class are CLR concepts.

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 name space.

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 IlteralContent, 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 computer-executable instructions for determining a hierarchy of common language runtime (CLR) 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 (a) one of a property and an event associated with the class and (b) one of another property and another event associated with another class, wherein the (a) one of a property and an event associated with the class and the (b) one of another property and another event associated with another class are CLR concepts.

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

22. The computer-readable medium of claim 20 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.

23. The computer-readable medium of claim 20 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.

24. The computer-readable medium of claim 20 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.

25. The computer-readable medium of claim 20 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.

26. The computer-readable medium of claim 20 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.

27. The computer-readable medium of claim 20 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.

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

29. The computer-readable medium of claim 20 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.

30. The computer-readable medium of claim 20 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.

31. The computer-readable medium of claim 20 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.

32. The computer-readable medium of claim 20 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.

33. The computer-readable medium of claim 20 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.

34. The computer-readable medium of claim 20 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.

35. The computer-readable medium of claim 34 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.

36. The computer-readable medium of claim 20 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.

37. The computer-readable medium of claim 36 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.

38. A mechanism for determining a hierarchy of common language runtime (CLR) objects from an extensible language markup file having a root tag comprising:

means for 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;

means for mapping a name of the tag to a class in the at least one namespace for each tag in the markup language file; and

means for mapping the attribute to (a) one of a property and an event associated with the class and (b) one of another property and another event associated with another class if the tag has an attribute, wherein the (a) one of a property and an event associated with the class and the (b) one of another property and another event associated with another class are CLR concepts.

39. The mechanism of claim 38 further comprising means for instantiating an object of the class.

40. The mechanism of claim 38 wherein the means for mapping the name of the tag to the class includes means for searching for the name of the tag in the at least one namespace.

41. The mechanism of claim 38 wherein the means for mapping the name of the tag to the class includes means for mapping the name of the tag to one of the class and the property.

42. The mechanism of claim 38 wherein the attribute has an attribute name, the means for mapping the attribute to one of a property and an event associated with the class comprises:

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

means for 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.

43. The mechanism of claim 38 further comprising:

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

means for 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;

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

means for 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

means for 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.

44. The mechanism of claim 38 wherein the one of the property and the event is the property, the mechanism further comprising:

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

if the attribute is an other tag;

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

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

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

45. The mechanism of claim 38 further comprising means for using a predefined meaning for the tag if the tag is a definition tag.

46. The mechanism of claim 45 wherein the means for using a predefined meaning for the tag includes means for parsing programming code if the tag is a code tag.

47. The mechanism of claim 38 further comprising:

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

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

means for setting the object as the value of the property.

48. The mechanism of claim 38 further comprising:

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

means for creating an instance of the object; and

means for setting the object as the value of the property.

49. The mechanism of claim 38 further comprising:

means for instantiating an object of the class;

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

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

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

50. The mechanism of claim 38 further comprising:

means for instantiating an object of the class;

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

51. The mechanism of claim 38 wherein the xmlns attribute has a link specifying a location of a resource directory, the mechanism further comprising:

means for fetching the namespace definition file from the resource directory; and

means for storing the namespace definition file locally.

52. The mechanism of claim 38 wherein the root tag is a tag indicating the extensible language markup file is a file specifying a fixed format document, the mechanism further comprising means for creating a fixed format document using classes in the at least one namespace.

53. The mechanism of claim 52 wherein the means for creating a fixed format document includes means for 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.

54. The mechanism of claim 38 wherein the root tag is a tag indicating the extensible language markup file is a file specifying an adaptive flow document, the mechanism further comprising means for specifying an adaptive flow document using tags mapped to classes in the at least one namespace.

55. The mechanism of claim 54 wherein the means for specifying an adaptive-flow document includes means for 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.

56. An apparatus to declaratively define a common language runtime (CLR) object comprising:

means for 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;

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

means for setting an attribute of the tag to a property name if the object has a property setting, wherein the means for mapping an uniform resource locator, means for setting a tag name to a class name and means for setting an attribute of the tag to a property name if the object has a property setting are used to create a document, wherein the class name and the property name are CLR concepts.

57. The apparatus of claim 56 further comprising means for setting the attribute of the tag to an event name if the object has an event defined.

58. The apparatus of claim 56 further comprising means for defining a definition tag to add one of programming code into a page and resources.

59. The apparatus of claim 56 wherein the means for defining a definition tag to add one of the programming code into the page and the resources comprises means for setting a def:

Code element to add the programming code into the page.

60. The apparatus of claim 56 further comprising means for defining a definition tag to add an attribute that is not associated with a class.

61. The apparatus of claim 60 wherein the means for defining a definition tag to add an attribute that is not associated with a class comprises means for setting a def:

Language attribute to specify a language used to compile code.

62. The apparatus of claim 56 further comprising means for 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.