go lucene

고루센

의존성 없이 go로 작성된 루씬 파서.

이 패키지를 사용하면 앱 내부에 Lucene 스타일 검색을 신속하게 통합하고 특정 쿼리에 대한 SQL 필터를 생성할 수 있습니다. 외부 종속성이 없으며 문법은 Apache Lucene 9.4.2를 완벽하게 지원합니다.

즉시 사용 가능한 go-lucene은 postgres 호환 sql 생성을 지원하지만 다양한 유형의 sql(또는 sql 없음)을 지원하도록 확장될 수도 있습니다.

용법

모든 필터가 포함된 단일 문자열을 생성하려면 lucene.ToPostgres 사용하세요.

lucene.ToParmeterizedPostgres 사용하여 DB 쿼리에 전달할 수 있는 인수가 포함된 매개변수화된 문자열을 생성하세요.

기본 리터럴을 필드와 연결하려면 lucene.WithDefaultField 옵션을 사용하세요.

순수 문자열

 // suppose you want a query for red apples that are not honey crisp or granny smith and are older than 5 months old
myQuery := `color:red AND NOT (type:"honey crisp" OR type:"granny smith") AND age_in_months:[5 TO *]`
filter , err := lucene . ToPostgres ( myQuery )
if err != nil {
    // handle error
}

SQLTemplate := `
SELECT *
FROM apples
WHERE %s
LIMIT 10;
`
sqlQuery := fmt . Sprintf ( SQLTemplate , filter )

// sqlQuery is:
`

SELECT *
FROM apples
WHERE
    (
		("color" = 'red') AND 
		(
			NOT(
				("type" = 'honey crisp') OR 
				("type" = 'granny smith')
			)
		)
	) AND 
	("age_in_months" >= 5)
LIMIT 10;
` 

매개변수화된 입력

 // suppose you want a query for red apples that are not honey crisp or granny smith and are older than 5 months old
myQuery := `color:red AND NOT (type:"honey crisp" OR type:"granny smith") AND age_in_months:[5 TO *]`
filter , params , err := lucene . ToParameterizedPostgres ( myQuery )
if err != nil {
    // handle error
}

SQLTemplate := `
SELECT *
FROM apples
WHERE %s
LIMIT 10;
`
sqlQuery := fmt . Sprintf ( SQLTemplate , filter )

db . Query ( sqlQuery , params )

기본 필드

 myQuery := "red OR green"
filter , err := lucene . ToPostgres (
	myQuery , lucene . WithDefaultField ( "appleColor" ))
if err != nil {
    // handle error
}

SQLTemplate := `
SELECT *
FROM apples
WHERE %s
LIMIT 10;
`
sqlQuery := fmt . Sprintf ( SQLTemplate , filter )

// sqlQuery is:
`
SELECT *
FROM apples
WHERE
    ("appleColor" = 'red') OR ("appleColor" = 'green')
LIMIT 10;
` 

사용자 정의 드라이버로 확장

사용자 정의 드라이버에 Base 드라이버를 삽입하고 사용자 정의 렌더링 기능으로 RenderFN 을 재정의하기만 하면 됩니다.

 import (
	"github.com/grindlemire/go-lucene"
	"github.com/grindlemire/go-lucene/pkg/driver"
	"github.com/grindlemire/go-lucene/pkg/lucene/expr"
)

type MyDriver struct {
	driver. Base
}
// Suppose we want a customer driver that is postgres but uses "==" rather than "=" for an equality check.
func NewMyDriver () MyDriver {
	// register your new custom render functions. Each render function
	// takes a left and optionally right rendered string and returns the rendered
	// output string for the entire expression.
	fns := map [expr. Operator ]driver. RenderFN {
		expr . Equals : myEquals ,
	}

	// iterate over the existing base render functions and swap out any that you want to
	for op , sharedFN := range driver . Shared {
		_ , found := fns [ op ]
		if ! found {
			fns [ op ] = sharedFN
		}
	}

	// return the new driver ready to use
	return MyDriver {
		driver. Base {
			RenderFNs : fns ,
		},
	}
}

// Suppose we wanted to implement equals using a "==" operator instead of "="
func myEquals ( left , right string ) ( string , error ) {
	return left + " == " + right , nil
}

...
func main () {
	// create a new instance of the driver
	driver := NewMyDriver ()

	// render an expression
	expr , _ := lucene . Parse ( `color:red AND NOT (type:"honey crisp" OR type:"granny smith") AND age_in_months:[5 TO *]` )
	filter , _ := driver . Render ( expr )
	
	SQLTemplate := `
	SELECT *
	FROM apples
	WHERE %s
	LIMIT 10;
	`
	sqlQuery := fmt . Sprintf ( SQLTemplate , filter )

	// sqlQuery is:
	`

	SELECT *
	FROM apples
	WHERE
		(
			("color" == 'red') AND 
			(
				NOT(
					("type" == 'honey crisp') OR 
					("type" == 'granny smith')
				)
			)
		) AND 
		("age_in_months" >= 5)
	LIMIT 10;
	`
}