xpp.go 7.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342
  1. package xpp
  2. import (
  3. "encoding/xml"
  4. "errors"
  5. "fmt"
  6. "io"
  7. "strings"
  8. )
  9. type XMLEventType int
  10. type CharsetReader func(charset string, input io.Reader) (io.Reader, error)
  11. const (
  12. StartDocument XMLEventType = iota
  13. EndDocument
  14. StartTag
  15. EndTag
  16. Text
  17. Comment
  18. ProcessingInstruction
  19. Directive
  20. IgnorableWhitespace // TODO: ?
  21. // TODO: CDSECT ?
  22. )
  23. type XMLPullParser struct {
  24. // Document State
  25. Spaces map[string]string
  26. SpacesStack []map[string]string
  27. // Token State
  28. Depth int
  29. Event XMLEventType
  30. Attrs []xml.Attr
  31. Name string
  32. Space string
  33. Text string
  34. decoder *xml.Decoder
  35. token interface{}
  36. }
  37. func NewXMLPullParser(r io.Reader, strict bool, cr CharsetReader) *XMLPullParser {
  38. d := xml.NewDecoder(r)
  39. d.Strict = strict
  40. d.CharsetReader = cr
  41. return &XMLPullParser{
  42. decoder: d,
  43. Event: StartDocument,
  44. Depth: 0,
  45. Spaces: map[string]string{},
  46. }
  47. }
  48. func (p *XMLPullParser) NextTag() (event XMLEventType, err error) {
  49. t, err := p.Next()
  50. if err != nil {
  51. return event, err
  52. }
  53. for t == Text && p.IsWhitespace() {
  54. t, err = p.Next()
  55. if err != nil {
  56. return event, err
  57. }
  58. }
  59. if t != StartTag && t != EndTag {
  60. return event, fmt.Errorf("Expected StartTag or EndTag but got %s at offset: %d", p.EventName(t), p.decoder.InputOffset())
  61. }
  62. return t, nil
  63. }
  64. func (p *XMLPullParser) Next() (event XMLEventType, err error) {
  65. for {
  66. event, err = p.NextToken()
  67. if err != nil {
  68. return event, err
  69. }
  70. // Return immediately after encountering a StartTag
  71. // EndTag, Text, EndDocument
  72. if event == StartTag ||
  73. event == EndTag ||
  74. event == EndDocument ||
  75. event == Text {
  76. return event, nil
  77. }
  78. // Skip Comment/Directive and ProcessingInstruction
  79. if event == Comment ||
  80. event == Directive ||
  81. event == ProcessingInstruction {
  82. continue
  83. }
  84. }
  85. return event, nil
  86. }
  87. func (p *XMLPullParser) NextToken() (event XMLEventType, err error) {
  88. // Clear any state held for the previous token
  89. p.resetTokenState()
  90. token, err := p.decoder.Token()
  91. if err != nil {
  92. if err == io.EOF {
  93. // XML decoder returns the EOF as an error
  94. // but we want to return it as a valid
  95. // EndDocument token instead
  96. p.token = nil
  97. p.Event = EndDocument
  98. return p.Event, nil
  99. }
  100. return event, err
  101. }
  102. p.token = xml.CopyToken(token)
  103. p.processToken(p.token)
  104. p.Event = p.EventType(p.token)
  105. return p.Event, nil
  106. }
  107. func (p *XMLPullParser) NextText() (string, error) {
  108. if p.Event != StartTag {
  109. return "", errors.New("Parser must be on StartTag to get NextText()")
  110. }
  111. t, err := p.Next()
  112. if err != nil {
  113. return "", err
  114. }
  115. if t != EndTag && t != Text {
  116. return "", errors.New("Parser must be on EndTag or Text to read text")
  117. }
  118. var result string
  119. for t == Text {
  120. result = result + p.Text
  121. t, err = p.Next()
  122. if err != nil {
  123. return "", err
  124. }
  125. if t != EndTag && t != Text {
  126. errstr := fmt.Sprintf("Event Text must be immediately followed by EndTag or Text but got %s", p.EventName(t))
  127. return "", errors.New(errstr)
  128. }
  129. }
  130. return result, nil
  131. }
  132. func (p *XMLPullParser) Skip() error {
  133. for {
  134. tok, err := p.NextToken()
  135. if err != nil {
  136. return err
  137. }
  138. if tok == StartTag {
  139. if err := p.Skip(); err != nil {
  140. return err
  141. }
  142. } else if tok == EndTag {
  143. return nil
  144. }
  145. }
  146. }
  147. func (p *XMLPullParser) Attribute(name string) string {
  148. for _, attr := range p.Attrs {
  149. if attr.Name.Local == name {
  150. return attr.Value
  151. }
  152. }
  153. return ""
  154. }
  155. func (p *XMLPullParser) Expect(event XMLEventType, name string) (err error) {
  156. return p.ExpectAll(event, "*", name)
  157. }
  158. func (p *XMLPullParser) ExpectAll(event XMLEventType, space string, name string) (err error) {
  159. if !(p.Event == event && (strings.ToLower(p.Space) == strings.ToLower(space) || space == "*") && (strings.ToLower(p.Name) == strings.ToLower(name) || name == "*")) {
  160. err = fmt.Errorf("Expected Space:%s Name:%s Event:%s but got Space:%s Name:%s Event:%s at offset: %d", space, name, p.EventName(event), p.Space, p.Name, p.EventName(p.Event), p.decoder.InputOffset())
  161. }
  162. return
  163. }
  164. func (p *XMLPullParser) DecodeElement(v interface{}) error {
  165. if p.Event != StartTag {
  166. return errors.New("DecodeElement can only be called from a StartTag event")
  167. }
  168. //tok := &p.token
  169. startToken := p.token.(xml.StartElement)
  170. // Consumes all tokens until the matching end token.
  171. err := p.decoder.DecodeElement(v, &startToken)
  172. if err != nil {
  173. return err
  174. }
  175. name := p.Name
  176. // Need to set the "current" token name/event
  177. // to the previous StartTag event's name
  178. p.resetTokenState()
  179. p.Event = EndTag
  180. p.Depth--
  181. p.Name = name
  182. p.token = nil
  183. return nil
  184. }
  185. func (p *XMLPullParser) IsWhitespace() bool {
  186. return strings.TrimSpace(p.Text) == ""
  187. }
  188. func (p *XMLPullParser) EventName(e XMLEventType) (name string) {
  189. switch e {
  190. case StartTag:
  191. name = "StartTag"
  192. case EndTag:
  193. name = "EndTag"
  194. case StartDocument:
  195. name = "StartDocument"
  196. case EndDocument:
  197. name = "EndDocument"
  198. case ProcessingInstruction:
  199. name = "ProcessingInstruction"
  200. case Directive:
  201. name = "Directive"
  202. case Comment:
  203. name = "Comment"
  204. case Text:
  205. name = "Text"
  206. case IgnorableWhitespace:
  207. name = "IgnorableWhitespace"
  208. }
  209. return
  210. }
  211. func (p *XMLPullParser) EventType(t xml.Token) (event XMLEventType) {
  212. switch t.(type) {
  213. case xml.StartElement:
  214. event = StartTag
  215. case xml.EndElement:
  216. event = EndTag
  217. case xml.CharData:
  218. event = Text
  219. case xml.Comment:
  220. event = Comment
  221. case xml.ProcInst:
  222. event = ProcessingInstruction
  223. case xml.Directive:
  224. event = Directive
  225. }
  226. return
  227. }
  228. func (p *XMLPullParser) processToken(t xml.Token) {
  229. switch tt := t.(type) {
  230. case xml.StartElement:
  231. p.processStartToken(tt)
  232. case xml.EndElement:
  233. p.processEndToken(tt)
  234. case xml.CharData:
  235. p.processCharDataToken(tt)
  236. case xml.Comment:
  237. p.processCommentToken(tt)
  238. case xml.ProcInst:
  239. p.processProcInstToken(tt)
  240. case xml.Directive:
  241. p.processDirectiveToken(tt)
  242. }
  243. }
  244. func (p *XMLPullParser) processStartToken(t xml.StartElement) {
  245. p.Depth++
  246. p.Attrs = t.Attr
  247. p.Name = t.Name.Local
  248. p.Space = t.Name.Space
  249. p.trackNamespaces(t)
  250. }
  251. func (p *XMLPullParser) processEndToken(t xml.EndElement) {
  252. p.Depth--
  253. p.SpacesStack = p.SpacesStack[:len(p.SpacesStack)-1]
  254. if len(p.SpacesStack) == 0 {
  255. p.Spaces = map[string]string{}
  256. } else {
  257. p.Spaces = p.SpacesStack[len(p.SpacesStack)-1]
  258. }
  259. p.Name = t.Name.Local
  260. }
  261. func (p *XMLPullParser) processCharDataToken(t xml.CharData) {
  262. p.Text = string([]byte(t))
  263. }
  264. func (p *XMLPullParser) processCommentToken(t xml.Comment) {
  265. p.Text = string([]byte(t))
  266. }
  267. func (p *XMLPullParser) processProcInstToken(t xml.ProcInst) {
  268. p.Text = fmt.Sprintf("%s %s", t.Target, string(t.Inst))
  269. }
  270. func (p *XMLPullParser) processDirectiveToken(t xml.Directive) {
  271. p.Text = string([]byte(t))
  272. }
  273. func (p *XMLPullParser) resetTokenState() {
  274. p.Attrs = nil
  275. p.Name = ""
  276. p.Space = ""
  277. p.Text = ""
  278. }
  279. func (p *XMLPullParser) trackNamespaces(t xml.StartElement) {
  280. newSpace := map[string]string{}
  281. for k, v := range p.Spaces {
  282. newSpace[k] = v
  283. }
  284. for _, attr := range t.Attr {
  285. if attr.Name.Space == "xmlns" {
  286. space := strings.TrimSpace(attr.Value)
  287. spacePrefix := strings.TrimSpace(strings.ToLower(attr.Name.Local))
  288. newSpace[space] = spacePrefix
  289. } else if attr.Name.Local == "xmlns" {
  290. space := strings.TrimSpace(attr.Value)
  291. newSpace[space] = ""
  292. }
  293. }
  294. p.Spaces = newSpace
  295. p.SpacesStack = append(p.SpacesStack, newSpace)
  296. }