highlight.go 11 KB

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