The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
/*
 * Copyright (C) 2008 Search Solution Corporation. All rights reserved by Search Solution.
 *
 * Redistribution and use in source and binary forms, with or without modification,
 * are permitted provided that the following conditions are met:
 *
 * - Redistributions of source code must retain the above copyright notice,
 *   this list of conditions and the following disclaimer.
 *
 * - Redistributions in binary form must reproduce the above copyright notice,
 *   this list of conditions and the following disclaimer in the documentation
 *   and/or other materials provided with the distribution.
 *
 * - Neither the name of the <ORGANIZATION> nor the names of its contributors
 *   may be used to endorse or promote products derived from this software without
 *   specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 * IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
 * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
 * OF SUCH DAMAGE.
 *
 */


/*
 * cci_query_execute.h -
 */

#ifndef	_CCI_QUERY_EXECUTE_H_
#define	_CCI_QUERY_EXECUTE_H_

#ident "$Id$"

/************************************************************************
 * IMPORTED SYSTEM HEADER FILES						*
 ************************************************************************/

/************************************************************************
 * IMPORTED OTHER HEADER FILES						*
 ************************************************************************/

#include "cas_cci.h"
#include "cci_handle_mng.h"
#include "cci_t_lob.h"

#ifdef CCI_XA
#include "cci_xa.h"
#endif

/************************************************************************
 * EXPORTED DEFINITIONS							*
 ************************************************************************/

#define BIND_PTR_STATIC		0
#define BIND_PTR_DYNAMIC	1

#define NET_STR_TO_INT64(INT64_VALUE, PTR)                              \
        do {                                                            \
          INT64           macro_var_tmp_value;                          \
          memcpy((char*) &macro_var_tmp_value, PTR, NET_SIZE_INT64);        \
          macro_var_tmp_value = ntohi64(macro_var_tmp_value);           \
          INT64_VALUE = macro_var_tmp_value;                            \
        } while (0)

#define NET_STR_TO_BIGINT(BIGINT_VALUE, PTR)  \
           NET_STR_TO_INT64(BIGINT_VALUE, PTR)

#define NET_STR_TO_INT(INT_VALUE, PTR)		                        \
	do {					                        \
	  int		macro_var_tmp_value;		                \
	  memcpy((char*) &macro_var_tmp_value, PTR, NET_SIZE_INT);	        \
	  macro_var_tmp_value = ntohl(macro_var_tmp_value);		\
	  INT_VALUE = macro_var_tmp_value;		                \
	} while (0)

#define NET_STR_TO_SHORT(SHORT_VALUE, PTR)	                        \
	do {					                        \
	  short		macro_var_tmp_value;		                \
	  memcpy((char*) &macro_var_tmp_value, PTR, NET_SIZE_SHORT);        \
	  macro_var_tmp_value = ntohs(macro_var_tmp_value);		\
	  SHORT_VALUE = macro_var_tmp_value;		                \
	} while (0)

#define NET_STR_TO_BYTE(BYTE_VALUE, PTR)                                \
        do {                                                            \
          (BYTE_VALUE) = *(char*)PTR;                                   \
        } while (0)

#define NET_STR_TO_FLOAT(FLOAT_VALUE, PTR)	                        \
	do {					                        \
	  float		macro_var_tmp_value;		                \
	  memcpy((char*) &macro_var_tmp_value, PTR, NET_SIZE_FLOAT);        \
	  macro_var_tmp_value = ntohf(macro_var_tmp_value);	        \
	  FLOAT_VALUE = macro_var_tmp_value;		                \
	} while (0)

#define NET_STR_TO_DOUBLE(DOUBLE_VALUE, PTR)	                        \
	do {					                        \
	  double	macro_var_tmp_value;		                \
	  memcpy((char*) &macro_var_tmp_value, PTR, NET_SIZE_DOUBLE);       \
	  macro_var_tmp_value = ntohd(macro_var_tmp_value);             \
	  DOUBLE_VALUE = macro_var_tmp_value;		                \
	} while (0)

#define NET_STR_TO_DATE(DATE_VAL, PTR)		                        \
	do {					                        \
	  short		macro_var_yr, macro_var_mon, macro_var_day;	\
	  int           pos = 0;                                        \
	  NET_STR_TO_SHORT(macro_var_yr, (PTR) + pos);		        \
	  pos += NET_SIZE_SHORT;                                            \
	  NET_STR_TO_SHORT(macro_var_mon, (PTR) + pos);	                \
	  pos += NET_SIZE_SHORT;                                            \
          NET_STR_TO_SHORT(macro_var_day, (PTR) + pos);	                \
	  (DATE_VAL).yr = macro_var_yr;			                \
	  (DATE_VAL).mon = macro_var_mon;			        \
	  (DATE_VAL).day = macro_var_day;			        \
	} while (0)

#define NET_STR_TO_TIME(TIME_VAL, PTR)		                        \
	do {					                        \
	  short	macro_var_hh, macro_var_mm, macro_var_ss;	        \
          int           pos = 0;                                        \
	  NET_STR_TO_SHORT(macro_var_hh, (PTR) + pos);                  \
          pos += NET_SIZE_SHORT;                                            \
	  NET_STR_TO_SHORT(macro_var_mm, (PTR) + pos);                  \
          pos += NET_SIZE_SHORT;                                            \
	  NET_STR_TO_SHORT(macro_var_ss, (PTR) + pos);                  \
	  (TIME_VAL).hh = macro_var_hh;			                \
	  (TIME_VAL).mm = macro_var_mm;			                \
	  (TIME_VAL).ss = macro_var_ss;			                \
	} while (0)

#define NET_STR_TO_MTIME(TIME_VAL, PTR)                                 \
        do {                                                            \
          short macro_var_hh, macro_var_mm, macro_var_ss, macro_var_ms; \
          int           pos = 0;                                        \
          NET_STR_TO_SHORT(macro_var_hh, (PTR) + pos);                  \
          pos += NET_SIZE_SHORT;                                            \
          NET_STR_TO_SHORT(macro_var_mm, (PTR) + pos);                  \
          pos += NET_SIZE_SHORT;                                            \
          NET_STR_TO_SHORT(macro_var_ss, (PTR) + pos);                  \
          pos += NET_SIZE_SHORT;                                            \
          NET_STR_TO_SHORT(macro_var_ms, (PTR) + pos);                  \
          (TIME_VAL).hh = macro_var_hh;                                 \
          (TIME_VAL).mm = macro_var_mm;                                 \
          (TIME_VAL).ss = macro_var_ss;                                 \
          (TIME_VAL).ms = macro_var_ms;                                 \
        } while (0)

#define NET_STR_TO_TIMESTAMP(TS_VAL, PTR)	        \
	do {					        \
	  NET_STR_TO_DATE((TS_VAL), (PTR));		\
	  NET_STR_TO_TIME((TS_VAL), (PTR) + NET_SIZE_DATE);	\
	} while (0)

#define NET_STR_TO_DATETIME(TS_VAL, PTR)                \
        do {                                            \
          NET_STR_TO_DATE((TS_VAL), (PTR));             \
          NET_STR_TO_MTIME((TS_VAL), (PTR) + NET_SIZE_DATE);\
        } while (0)

#define NET_STR_TO_OBJECT(OBJ_VAL, PTR)		                \
	do {					                \
	  int		macro_var_pageid;		        \
	  short 	macro_var_volid, macro_var_slotid;	\
          int           pos = 0;                                \
	  NET_STR_TO_INT(macro_var_pageid, (PTR) + pos);	\
          pos += NET_SIZE_INT;                                      \
	  NET_STR_TO_SHORT(macro_var_slotid, (PTR) + pos);	\
          pos += NET_SIZE_SHORT;                                    \
	  NET_STR_TO_SHORT(macro_var_volid, (PTR) + pos);	\
	  (OBJ_VAL).pageid = macro_var_pageid;		        \
	  (OBJ_VAL).slotid = macro_var_slotid;		        \
	  (OBJ_VAL).volid = macro_var_volid;		        \
	} while (0)

#define ADD_ARG_INT(BUF, VALUE)			\
	do {					\
	  net_buf_cp_int((BUF), NET_SIZE_INT);	\
	  net_buf_cp_int((BUF), (VALUE));	\
	} while (0)

#define ADD_ARG_INT64(BUF, VALUE)               \
        do {                                    \
          net_buf_cp_int((BUF), NET_SIZE_INT64);    \
          net_buf_cp_bigint((BUF), (VALUE));    \
        } while (0)

#define ADD_ARG_BIGINT(BUF, VALUE)  ADD_ARG_INT64(BUF, VALUE)


#ifdef UNICODE_DATA
#define ADD_ARG_STR(BUF, STR, SIZE, CHARSET)			\
	do {							\
	  char *_macro_tmp_str = STR;				\
	  int _macro_tmp_int = 0;				\
	  _macro_tmp_str = ut_ansi_to_unicode(STR);		\
	  if (_macro_tmp_str != NULL)				\
	    _macro_tmp_int = strlen(_macro_tmp_str) + 1;	\
	  net_buf_cp_int(BUF, _macro_tmp_int);			\
	  net_buf_cp_str(BUF, _macro_tmp_str, _macro_tmp_int);	\
	  FREE_MEM(_macro_tmp_str);				\
	} while (0)
#else
#if defined (WINDOWS)
#define ADD_ARG_STR(BUF, STR, SIZE, CHARSET)		 \
	do {                                             \
 	  if (CHARSET != NULL) {                         \
 	    int new_size;                                \
 	    char * target;                               \
	    new_size = encode_string(STR, SIZE, &target, CHARSET);\
 	    if (new_size < 0)                            \
 	      {                                          \
 		return new_size;                         \
 	      }                                          \
	    else if (new_size == 0)                      \
	      {                                          \
 	        ADD_ARG_BYTES(BUF, STR, SIZE);           \
	      }                                          \
	    else                                         \
	      {                                          \
 	        ADD_ARG_BYTES(BUF, target, new_size);    \
 	        free (target);                           \
	      }                                          \
 	  }                                              \
 	  else {                                         \
 	    ADD_ARG_BYTES(BUF, STR, SIZE);               \
 	  }                                              \
 	} while (0)
#else
#define ADD_ARG_STR(BUF, STR, SIZE, CHARSET)		 \
 	ADD_ARG_BYTES(BUF, STR, SIZE);
#endif
#endif

#define ADD_ARG_BYTES(BUF, STR, SIZE)		\
	do {					\
	  net_buf_cp_int(BUF, SIZE);		\
	  net_buf_cp_str(BUF, (char*) STR, SIZE);	\
	} while (0)

#define ADD_ARG_FLOAT(BUF, VALUE)		\
	do {					\
	  net_buf_cp_int(BUF, NET_SIZE_FLOAT);      \
	  net_buf_cp_float(BUF, VALUE);		\
	} while (0)

#define ADD_ARG_DOUBLE(BUF, VALUE)		\
	do {					\
	  net_buf_cp_int(BUF, NET_SIZE_DOUBLE);	\
	  net_buf_cp_double(BUF, VALUE);	\
	} while (0)

#define ADD_ARG_DATETIME(BUF, VALUE_P)		\
	do {					\
	  T_CCI_DATE	*macro_var_date_p = (T_CCI_DATE*) (VALUE_P);	\
	  net_buf_cp_int(BUF, NET_SIZE_DATETIME);	\
	  net_buf_cp_short(BUF, macro_var_date_p->yr);	\
	  net_buf_cp_short(BUF, macro_var_date_p->mon);	\
	  net_buf_cp_short(BUF, macro_var_date_p->day);	\
	  net_buf_cp_short(BUF, macro_var_date_p->hh);	\
	  net_buf_cp_short(BUF, macro_var_date_p->mm);	\
	  net_buf_cp_short(BUF, macro_var_date_p->ss);	\
          net_buf_cp_short(BUF, macro_var_date_p->ms);  \
	} while (0)

#define ADD_ARG_OBJECT(BUF, OID_P)			\
	do {						\
	  T_OBJECT	*macro_var_obj_p = (T_OBJECT*) (OID_P);	\
	  net_buf_cp_int(BUF, NET_SIZE_OBJECT);		\
	  net_buf_cp_int(BUF, macro_var_obj_p->pageid);		\
	  net_buf_cp_short(BUF, macro_var_obj_p->slotid);		\
	  net_buf_cp_short(BUF, macro_var_obj_p->volid);		\
	} while (0)

#define ADD_ARG_CACHE_TIME(BUF, SEC, USEC)	\
	do {					\
	  net_buf_cp_int(BUF, NET_SIZE_INT*2);	\
	  net_buf_cp_int(BUF, SEC);		\
	  net_buf_cp_int(BUF, USEC);		\
	} while (0)

#define ADD_ARG_LOB(BUF, VALUE_P)		\
	do {					\
	  T_LOB		*macro_var_lob_p = (T_LOB*) (VALUE_P);	\
	  net_buf_cp_int(BUF, macro_var_lob_p->handle_size);	\
	  net_buf_cp_str(BUF, (char*) macro_var_lob_p->handle, macro_var_lob_p->handle_size);	\
	} while (0)


/************************************************************************
 * EXPORTED TYPE DEFINITIONS						*
 ************************************************************************/

/************************************************************************
 * EXPORTED FUNCTION PROTOTYPES						*
 ************************************************************************/

extern int qe_con_close (T_CON_HANDLE * con_handle);
extern int qe_prepare (T_REQ_HANDLE * req_handle,
		       T_CON_HANDLE * con_handle,
		       char *sql_stmt,
		       char flag, T_CCI_ERROR * err_buf, int reuse);
extern int qe_prepare_and_execute (T_REQ_HANDLE * req_handle,
				   T_CON_HANDLE * con_handle,
				   char *sql_stmt, int max_col_size,
				   T_CCI_ERROR * err_buf);

extern void qe_bind_value_free (int num_bind, T_BIND_VALUE * bind_value);
extern int qe_bind_param (T_REQ_HANDLE * req_handle,
			  int index,
			  T_CCI_A_TYPE a_type,
			  void *value, T_CCI_U_TYPE u_type, char flag);
extern int qe_execute (T_REQ_HANDLE * req_handle,
		       T_CON_HANDLE * con_handle,
		       char flag, int max_col_size, T_CCI_ERROR * err_buf);
extern int qe_end_tran (T_CON_HANDLE * con_handle,
			char type, T_CCI_ERROR * err_buf);
extern int qe_end_session (T_CON_HANDLE * con_handle, T_CCI_ERROR * err_buf);
extern int qe_get_db_parameter (T_CON_HANDLE * con_handle,
				T_CCI_DB_PARAM param_name,
				void *value, T_CCI_ERROR * err_buf);
extern int qe_set_db_parameter (T_CON_HANDLE * con_handle,
				T_CCI_DB_PARAM param_name,
				void *value, T_CCI_ERROR * err_buf);
extern int qe_close_req_handle (T_REQ_HANDLE * req_handle,
				T_CON_HANDLE * con_handle);
extern void qe_close_req_handle_all (T_CON_HANDLE * con_handle);
extern int qe_cursor (T_REQ_HANDLE * req_handle, T_CON_HANDLE * con_handle,
		      int offset, char origin, T_CCI_ERROR * err_buf);
extern int qe_fetch (T_REQ_HANDLE * req_handle, T_CON_HANDLE * con_handle,
		     char flag, int result_set_index, T_CCI_ERROR * err_buf);
extern int qe_get_data (T_CON_HANDLE * con_handle, T_REQ_HANDLE * req_handle,
			int col_no, int a_type, void *value, int *indicator);
extern int qe_get_cur_oid (T_REQ_HANDLE * req_handle, char *oid_str_buf);
extern int qe_schema_info (T_REQ_HANDLE * req_handle,
			   T_CON_HANDLE * con_handle,
			   int type, char *arg1, char *arg2,
			   char flag, int shard_id, T_CCI_ERROR * err_buf);
extern int qe_oid_get (T_REQ_HANDLE * req_handle,
		       T_CON_HANDLE * con_handle,
		       char *oid_str,
		       char **attr_name, T_CCI_ERROR * err_buf);
extern int qe_oid_put (T_CON_HANDLE * con_handle,
		       char *oid_str,
		       char **attr_name,
		       char **new_val, T_CCI_ERROR * err_buf);
extern int qe_oid_put2 (T_CON_HANDLE * con_handle,
			char *oid_str,
			char **attr_name,
			void **new_val, int *a_type, T_CCI_ERROR * err_buf);
extern int qe_get_db_version (T_CON_HANDLE * con_handle,
			      char *out_buf, int buf_size);
extern int qe_get_class_num_objs (T_CON_HANDLE * con_handle,
				  char *class_name,
				  char flag,
				  int *num_objs,
				  int *num_pages, T_CCI_ERROR * err_buf);
extern int qe_oid_cmd (T_CON_HANDLE * con_handle,
		       char cmd,
		       char *oid_str,
		       char *out_buf,
		       int out_buf_size, T_CCI_ERROR * err_buf);
extern int qe_col_get (T_REQ_HANDLE * req_handle,
		       T_CON_HANDLE * con_handle,
		       char *oid_str,
		       const char *col_attr,
		       int *col_size, int *col_type, T_CCI_ERROR * err_buf);
extern int qe_get_row_count (T_REQ_HANDLE * req_handle,
			     T_CON_HANDLE * con_handle,
			     int *row_count, T_CCI_ERROR * err_buf);
extern int qe_get_last_insert_id (T_REQ_HANDLE * req_handle,
				  T_CON_HANDLE * con_handle,
				  void *value, T_CCI_ERROR * err_buf);
extern int qe_col_size (T_CON_HANDLE * con_handle,
			char *oid_str,
			const char *col_attr, int *col_size,
			T_CCI_ERROR * err_buf);
extern int qe_col_set_add_drop (T_CON_HANDLE * con_handle, char col_cmd,
				char *oid_str, const char *col_attr,
				char *value, T_CCI_ERROR * err_buf);
extern int qe_col_seq_op (T_CON_HANDLE * con_handle, char col_cmd,
			  char *oid_str, const char *col_attr, int index,
			  const char *value, T_CCI_ERROR * err_buf);

extern int qe_next_result (T_REQ_HANDLE * req_handle,
			   char flag, T_CON_HANDLE * con_handle,
			   T_CCI_ERROR * err_buf);
extern int qe_execute_array (T_REQ_HANDLE * req_handle,
			     T_CON_HANDLE * con_handle,
			     T_CCI_QUERY_RESULT ** qr, T_CCI_ERROR * err_buf);
extern void qe_query_result_free (int num_q, T_CCI_QUERY_RESULT * qr);
extern int qe_cursor_update (T_REQ_HANDLE * req_handle,
			     T_CON_HANDLE * con_handle,
			     int cursor_pos,
			     int index,
			     T_CCI_A_TYPE a_type,
			     void *value, T_CCI_ERROR * err_buf);
extern int qe_execute_batch (T_CON_HANDLE * con_handle,
			     int num_query,
			     char **sql_stmt,
			     T_CCI_QUERY_RESULT ** qr, T_CCI_ERROR * err_buf);
extern int qe_query_result_copy (T_REQ_HANDLE * req_handle,
				 T_CCI_QUERY_RESULT ** res_qr);

extern int qe_get_data_str (T_VALUE_BUF * conv_val_buf,
			    T_CCI_U_TYPE u_type,
			    char *col_value_p,
			    int col_val_size, void *value, int *indicator);
extern int qe_get_data_bigint (T_CCI_U_TYPE u_type, char *col_value_p,
			       void *value);
extern int qe_get_data_int (T_CCI_U_TYPE u_type,
			    char *col_value_p, void *value);
extern int qe_get_data_float (T_CCI_U_TYPE u_type,
			      char *col_value_p, void *value);
extern int qe_get_data_double (T_CCI_U_TYPE u_type,
			       char *col_value_p, void *value);
extern int qe_get_data_date (T_CCI_U_TYPE u_type,
			     char *col_value_p, void *value);
extern int qe_get_data_bit (T_CCI_U_TYPE u_type,
			    char *col_value_p, int col_val_size, void *value);
extern int qe_get_data_lob (T_CCI_U_TYPE u_type,
			    char *col_value_p, int col_val_size, void *value);
extern int qe_get_data_req_handle (T_CON_HANDLE * con_handle,
				   T_REQ_HANDLE * req_handle,
				   char *col_value_p, void *value);
extern int qe_get_attr_type_str (T_CON_HANDLE * con_handle, char *class_name,
				 char *attr_name, char *buf, int buf_size,
				 T_CCI_ERROR * err_buf);
extern int qe_get_query_info (T_REQ_HANDLE * req_handle,
			      T_CON_HANDLE * con_handle, char log_type,
			      char **out_buf);
extern int qe_savepoint_cmd (T_CON_HANDLE * con_handle, char cmd,
			     const char *savepoint_name,
			     T_CCI_ERROR * err_buf);
extern int qe_get_param_info (T_REQ_HANDLE * req_handle,
			      T_CON_HANDLE * con_handle,
			      T_CCI_PARAM_INFO ** param,
			      T_CCI_ERROR * err_buf);
extern void qe_param_info_free (T_CCI_PARAM_INFO * param);

#if defined(WINDOWS)
extern int qe_set_charset (T_CON_HANDLE * con_handle, char *str);
extern int encode_string (char *str, int size, char **target, char *charset);
#endif

#ifdef CCI_XA
extern int qe_xa_prepare (T_CON_HANDLE * con_handle,
			  XID * xid, T_CCI_ERROR * err_buf);
extern int qe_xa_recover (T_CON_HANDLE * con_handle,
			  XID * xid, int num_xid, T_CCI_ERROR * err_buf);
extern int qe_xa_end_tran (T_CON_HANDLE * con_handle,
			   XID * xid, char type, T_CCI_ERROR * err_buf);
#endif

extern int qe_lob_new (T_CON_HANDLE * con_handle, T_LOB ** lob,
		       T_CCI_U_TYPE type, T_CCI_ERROR * err_buf);
extern int qe_lob_write (T_CON_HANDLE * con_handle, T_LOB * lob,
			 INT64 start_pos, int length, const char *buf,
			 T_CCI_ERROR * err_buf);
extern int qe_lob_read (T_CON_HANDLE * con_handle, T_LOB * lob,
			INT64 start_pos, int length, char *buf,
			T_CCI_ERROR * err_buf);

extern int qe_get_shard_info (T_CON_HANDLE * con_handle,
			      T_CCI_SHARD_INFO ** shard_info,
			      T_CCI_ERROR * err_buf);
extern int qe_shard_info_free (T_CCI_SHARD_INFO * shard_info);
extern int qe_is_shard (T_CON_HANDLE * con_handle);
extern bool is_connected_to_oracle (T_CON_HANDLE * con_handle);

/************************************************************************
 * EXPORTED VARIABLES							*
 ************************************************************************/
#endif /* _CCI_QUERY_EXECUTE_H_ */