highlight.go 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496
  1. // Copyright 2012-2015 Oliver Eilhard. All rights reserved.
  2. // Use of this source code is governed by a MIT-license.
  3. // See http://olivere.mit-license.org/license.txt for details.
  4. package elastic
  5. // Highlight allows highlighting search results on one or more fields.
  6. // For details, see:
  7. // http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/search-request-highlighting.html
  8. type Highlight struct {
  9. fields []*HighlighterField
  10. tagsSchema *string
  11. highlightFilter *bool
  12. fragmentSize *int
  13. numOfFragments *int
  14. preTags []string
  15. postTags []string
  16. order *string
  17. encoder *string
  18. requireFieldMatch *bool
  19. boundaryMaxScan *int
  20. boundaryChars []rune
  21. highlighterType *string
  22. fragmenter *string
  23. highlightQuery Query
  24. noMatchSize *int
  25. phraseLimit *int
  26. options map[string]interface{}
  27. forceSource *bool
  28. useExplicitFieldOrder bool
  29. }
  30. func NewHighlight() *Highlight {
  31. hl := &Highlight{
  32. fields: make([]*HighlighterField, 0),
  33. preTags: make([]string, 0),
  34. postTags: make([]string, 0),
  35. boundaryChars: make([]rune, 0),
  36. options: make(map[string]interface{}),
  37. }
  38. return hl
  39. }
  40. func (hl *Highlight) Fields(fields ...*HighlighterField) *Highlight {
  41. hl.fields = append(hl.fields, fields...)
  42. return hl
  43. }
  44. func (hl *Highlight) Field(name string) *Highlight {
  45. field := NewHighlighterField(name)
  46. hl.fields = append(hl.fields, field)
  47. return hl
  48. }
  49. func (hl *Highlight) TagsSchema(schemaName string) *Highlight {
  50. hl.tagsSchema = &schemaName
  51. return hl
  52. }
  53. func (hl *Highlight) HighlightFilter(highlightFilter bool) *Highlight {
  54. hl.highlightFilter = &highlightFilter
  55. return hl
  56. }
  57. func (hl *Highlight) FragmentSize(fragmentSize int) *Highlight {
  58. hl.fragmentSize = &fragmentSize
  59. return hl
  60. }
  61. func (hl *Highlight) NumOfFragments(numOfFragments int) *Highlight {
  62. hl.numOfFragments = &numOfFragments
  63. return hl
  64. }
  65. func (hl *Highlight) Encoder(encoder string) *Highlight {
  66. hl.encoder = &encoder
  67. return hl
  68. }
  69. func (hl *Highlight) PreTags(preTags ...string) *Highlight {
  70. hl.preTags = make([]string, 0)
  71. hl.preTags = append(hl.preTags, preTags...)
  72. return hl
  73. }
  74. func (hl *Highlight) PostTags(postTags ...string) *Highlight {
  75. hl.postTags = make([]string, 0)
  76. hl.postTags = append(hl.postTags, postTags...)
  77. return hl
  78. }
  79. func (hl *Highlight) Order(order string) *Highlight {
  80. hl.order = &order
  81. return hl
  82. }
  83. func (hl *Highlight) RequireFieldMatch(requireFieldMatch bool) *Highlight {
  84. hl.requireFieldMatch = &requireFieldMatch
  85. return hl
  86. }
  87. func (hl *Highlight) BoundaryMaxScan(boundaryMaxScan int) *Highlight {
  88. hl.boundaryMaxScan = &boundaryMaxScan
  89. return hl
  90. }
  91. func (hl *Highlight) BoundaryChars(boundaryChars ...rune) *Highlight {
  92. hl.boundaryChars = make([]rune, 0)
  93. hl.boundaryChars = append(hl.boundaryChars, boundaryChars...)
  94. return hl
  95. }
  96. func (hl *Highlight) HighlighterType(highlighterType string) *Highlight {
  97. hl.highlighterType = &highlighterType
  98. return hl
  99. }
  100. func (hl *Highlight) Fragmenter(fragmenter string) *Highlight {
  101. hl.fragmenter = &fragmenter
  102. return hl
  103. }
  104. func (hl *Highlight) HighlighQuery(highlightQuery Query) *Highlight {
  105. hl.highlightQuery = highlightQuery
  106. return hl
  107. }
  108. func (hl *Highlight) NoMatchSize(noMatchSize int) *Highlight {
  109. hl.noMatchSize = &noMatchSize
  110. return hl
  111. }
  112. func (hl *Highlight) Options(options map[string]interface{}) *Highlight {
  113. hl.options = options
  114. return hl
  115. }
  116. func (hl *Highlight) ForceSource(forceSource bool) *Highlight {
  117. hl.forceSource = &forceSource
  118. return hl
  119. }
  120. func (hl *Highlight) UseExplicitFieldOrder(useExplicitFieldOrder bool) *Highlight {
  121. hl.useExplicitFieldOrder = useExplicitFieldOrder
  122. return hl
  123. }
  124. // Creates the query source for the bool query.
  125. func (hl *Highlight) Source() interface{} {
  126. // Returns the map inside of "highlight":
  127. // "highlight":{
  128. // ... this ...
  129. // }
  130. source := make(map[string]interface{})
  131. if hl.tagsSchema != nil {
  132. source["tags_schema"] = *hl.tagsSchema
  133. }
  134. if hl.preTags != nil && len(hl.preTags) > 0 {
  135. source["pre_tags"] = hl.preTags
  136. }
  137. if hl.postTags != nil && len(hl.postTags) > 0 {
  138. source["post_tags"] = hl.postTags
  139. }
  140. if hl.order != nil {
  141. source["order"] = *hl.order
  142. }
  143. if hl.highlightFilter != nil {
  144. source["highlight_filter"] = *hl.highlightFilter
  145. }
  146. if hl.fragmentSize != nil {
  147. source["fragment_size"] = *hl.fragmentSize
  148. }
  149. if hl.numOfFragments != nil {
  150. source["number_of_fragments"] = *hl.numOfFragments
  151. }
  152. if hl.encoder != nil {
  153. source["encoder"] = *hl.encoder
  154. }
  155. if hl.requireFieldMatch != nil {
  156. source["require_field_match"] = *hl.requireFieldMatch
  157. }
  158. if hl.boundaryMaxScan != nil {
  159. source["boundary_max_scan"] = *hl.boundaryMaxScan
  160. }
  161. if hl.boundaryChars != nil && len(hl.boundaryChars) > 0 {
  162. source["boundary_chars"] = hl.boundaryChars
  163. }
  164. if hl.highlighterType != nil {
  165. source["type"] = *hl.highlighterType
  166. }
  167. if hl.fragmenter != nil {
  168. source["fragmenter"] = *hl.fragmenter
  169. }
  170. if hl.highlightQuery != nil {
  171. source["highlight_query"] = hl.highlightQuery.Source()
  172. }
  173. if hl.noMatchSize != nil {
  174. source["no_match_size"] = *hl.noMatchSize
  175. }
  176. if hl.phraseLimit != nil {
  177. source["phrase_limit"] = *hl.phraseLimit
  178. }
  179. if hl.options != nil && len(hl.options) > 0 {
  180. source["options"] = hl.options
  181. }
  182. if hl.forceSource != nil {
  183. source["force_source"] = *hl.forceSource
  184. }
  185. if hl.fields != nil && len(hl.fields) > 0 {
  186. if hl.useExplicitFieldOrder {
  187. // Use a slice for the fields
  188. fields := make([]map[string]interface{}, 0)
  189. for _, field := range hl.fields {
  190. fmap := make(map[string]interface{})
  191. fmap[field.Name] = field.Source()
  192. fields = append(fields, fmap)
  193. }
  194. source["fields"] = fields
  195. } else {
  196. // Use a map for the fields
  197. fields := make(map[string]interface{}, 0)
  198. for _, field := range hl.fields {
  199. fields[field.Name] = field.Source()
  200. }
  201. source["fields"] = fields
  202. }
  203. }
  204. return source
  205. /*
  206. highlightS := make(map[string]interface{})
  207. if hl.tagsSchema != "" {
  208. highlightS["tags_schema"] = hl.tagsSchema
  209. }
  210. if len(hl.preTags) > 0 {
  211. highlightS["pre_tags"] = hl.preTags
  212. }
  213. if len(hl.postTags) > 0 {
  214. highlightS["post_tags"] = hl.postTags
  215. }
  216. if hl.order != "" {
  217. highlightS["order"] = hl.order
  218. }
  219. if hl.encoder != "" {
  220. highlightS["encoder"] = hl.encoder
  221. }
  222. if hl.requireFieldMatch != nil {
  223. highlightS["require_field_match"] = *hl.requireFieldMatch
  224. }
  225. if hl.highlighterType != "" {
  226. highlightS["type"] = hl.highlighterType
  227. }
  228. if hl.fragmenter != "" {
  229. highlightS["fragmenter"] = hl.fragmenter
  230. }
  231. if hl.highlightQuery != nil {
  232. highlightS["highlight_query"] = hl.highlightQuery.Source()
  233. }
  234. if hl.noMatchSize != nil {
  235. highlightS["no_match_size"] = *hl.noMatchSize
  236. }
  237. if len(hl.options) > 0 {
  238. highlightS["options"] = hl.options
  239. }
  240. if hl.forceSource != nil {
  241. highlightS["force_source"] = *hl.forceSource
  242. }
  243. if len(hl.fields) > 0 {
  244. fieldsS := make(map[string]interface{})
  245. for _, field := range hl.fields {
  246. fieldsS[field.Name] = field.Source()
  247. }
  248. highlightS["fields"] = fieldsS
  249. }
  250. return highlightS
  251. */
  252. }
  253. // HighlighterField specifies a highlighted field.
  254. type HighlighterField struct {
  255. Name string
  256. preTags []string
  257. postTags []string
  258. fragmentSize int
  259. fragmentOffset int
  260. numOfFragments int
  261. highlightFilter *bool
  262. order *string
  263. requireFieldMatch *bool
  264. boundaryMaxScan int
  265. boundaryChars []rune
  266. highlighterType *string
  267. fragmenter *string
  268. highlightQuery Query
  269. noMatchSize *int
  270. matchedFields []string
  271. phraseLimit *int
  272. options map[string]interface{}
  273. forceSource *bool
  274. /*
  275. Name string
  276. preTags []string
  277. postTags []string
  278. fragmentSize int
  279. numOfFragments int
  280. fragmentOffset int
  281. highlightFilter *bool
  282. order string
  283. requireFieldMatch *bool
  284. boundaryMaxScan int
  285. boundaryChars []rune
  286. highlighterType string
  287. fragmenter string
  288. highlightQuery Query
  289. noMatchSize *int
  290. matchedFields []string
  291. options map[string]interface{}
  292. forceSource *bool
  293. */
  294. }
  295. func NewHighlighterField(name string) *HighlighterField {
  296. return &HighlighterField{
  297. Name: name,
  298. preTags: make([]string, 0),
  299. postTags: make([]string, 0),
  300. fragmentSize: -1,
  301. fragmentOffset: -1,
  302. numOfFragments: -1,
  303. boundaryMaxScan: -1,
  304. boundaryChars: make([]rune, 0),
  305. matchedFields: make([]string, 0),
  306. options: make(map[string]interface{}),
  307. }
  308. }
  309. func (f *HighlighterField) PreTags(preTags ...string) *HighlighterField {
  310. f.preTags = make([]string, 0)
  311. f.preTags = append(f.preTags, preTags...)
  312. return f
  313. }
  314. func (f *HighlighterField) PostTags(postTags ...string) *HighlighterField {
  315. f.postTags = make([]string, 0)
  316. f.postTags = append(f.postTags, postTags...)
  317. return f
  318. }
  319. func (f *HighlighterField) FragmentSize(fragmentSize int) *HighlighterField {
  320. f.fragmentSize = fragmentSize
  321. return f
  322. }
  323. func (f *HighlighterField) FragmentOffset(fragmentOffset int) *HighlighterField {
  324. f.fragmentOffset = fragmentOffset
  325. return f
  326. }
  327. func (f *HighlighterField) NumOfFragments(numOfFragments int) *HighlighterField {
  328. f.numOfFragments = numOfFragments
  329. return f
  330. }
  331. func (f *HighlighterField) HighlightFilter(highlightFilter bool) *HighlighterField {
  332. f.highlightFilter = &highlightFilter
  333. return f
  334. }
  335. func (f *HighlighterField) Order(order string) *HighlighterField {
  336. f.order = &order
  337. return f
  338. }
  339. func (f *HighlighterField) RequireFieldMatch(requireFieldMatch bool) *HighlighterField {
  340. f.requireFieldMatch = &requireFieldMatch
  341. return f
  342. }
  343. func (f *HighlighterField) BoundaryMaxScan(boundaryMaxScan int) *HighlighterField {
  344. f.boundaryMaxScan = boundaryMaxScan
  345. return f
  346. }
  347. func (f *HighlighterField) BoundaryChars(boundaryChars ...rune) *HighlighterField {
  348. f.boundaryChars = make([]rune, 0)
  349. f.boundaryChars = append(f.boundaryChars, boundaryChars...)
  350. return f
  351. }
  352. func (f *HighlighterField) HighlighterType(highlighterType string) *HighlighterField {
  353. f.highlighterType = &highlighterType
  354. return f
  355. }
  356. func (f *HighlighterField) Fragmenter(fragmenter string) *HighlighterField {
  357. f.fragmenter = &fragmenter
  358. return f
  359. }
  360. func (f *HighlighterField) HighlightQuery(highlightQuery Query) *HighlighterField {
  361. f.highlightQuery = highlightQuery
  362. return f
  363. }
  364. func (f *HighlighterField) NoMatchSize(noMatchSize int) *HighlighterField {
  365. f.noMatchSize = &noMatchSize
  366. return f
  367. }
  368. func (f *HighlighterField) Options(options map[string]interface{}) *HighlighterField {
  369. f.options = options
  370. return f
  371. }
  372. func (f *HighlighterField) MatchedFields(matchedFields ...string) *HighlighterField {
  373. f.matchedFields = make([]string, 0)
  374. f.matchedFields = append(f.matchedFields, matchedFields...)
  375. return f
  376. }
  377. func (f *HighlighterField) PhraseLimit(phraseLimit int) *HighlighterField {
  378. f.phraseLimit = &phraseLimit
  379. return f
  380. }
  381. func (f *HighlighterField) ForceSource(forceSource bool) *HighlighterField {
  382. f.forceSource = &forceSource
  383. return f
  384. }
  385. func (f *HighlighterField) Source() interface{} {
  386. source := make(map[string]interface{})
  387. if f.preTags != nil && len(f.preTags) > 0 {
  388. source["pre_tags"] = f.preTags
  389. }
  390. if f.postTags != nil && len(f.postTags) > 0 {
  391. source["post_tags"] = f.postTags
  392. }
  393. if f.fragmentSize != -1 {
  394. source["fragment_size"] = f.fragmentSize
  395. }
  396. if f.numOfFragments != -1 {
  397. source["number_of_fragments"] = f.numOfFragments
  398. }
  399. if f.fragmentOffset != -1 {
  400. source["fragment_offset"] = f.fragmentOffset
  401. }
  402. if f.highlightFilter != nil {
  403. source["highlight_filter"] = *f.highlightFilter
  404. }
  405. if f.order != nil {
  406. source["order"] = *f.order
  407. }
  408. if f.requireFieldMatch != nil {
  409. source["require_field_match"] = *f.requireFieldMatch
  410. }
  411. if f.boundaryMaxScan != -1 {
  412. source["boundary_max_scan"] = f.boundaryMaxScan
  413. }
  414. if f.boundaryChars != nil && len(f.boundaryChars) > 0 {
  415. source["boundary_chars"] = f.boundaryChars
  416. }
  417. if f.highlighterType != nil {
  418. source["type"] = *f.highlighterType
  419. }
  420. if f.fragmenter != nil {
  421. source["fragmenter"] = *f.fragmenter
  422. }
  423. if f.highlightQuery != nil {
  424. source["highlight_query"] = f.highlightQuery.Source()
  425. }
  426. if f.noMatchSize != nil {
  427. source["no_match_size"] = *f.noMatchSize
  428. }
  429. if f.matchedFields != nil && len(f.matchedFields) > 0 {
  430. source["matched_fields"] = f.matchedFields
  431. }
  432. if f.phraseLimit != nil {
  433. source["phrase_limit"] = *f.phraseLimit
  434. }
  435. if f.options != nil && len(f.options) > 0 {
  436. source["options"] = f.options
  437. }
  438. if f.forceSource != nil {
  439. source["force_source"] = *f.forceSource
  440. }
  441. return source
  442. }