diff options
Diffstat (limited to 'doc/latex/classBiblioIsisDb.tex')
-rw-r--r-- | doc/latex/classBiblioIsisDb.tex | 312 |
1 files changed, 312 insertions, 0 deletions
diff --git a/doc/latex/classBiblioIsisDb.tex b/doc/latex/classBiblioIsisDb.tex new file mode 100644 index 0000000..4e933f9 --- /dev/null +++ b/doc/latex/classBiblioIsisDb.tex @@ -0,0 +1,312 @@ +\hypertarget{classBiblioIsisDb}{ +\section{BiblioIsisDb Class Reference} +\label{classBiblioIsisDb}\index{BiblioIsisDb@{BiblioIsisDb}} +} +Inheritance diagram for BiblioIsisDb:\begin{figure}[H] +\begin{center} +\leavevmode +\includegraphics[height=2cm]{classBiblioIsisDb} +\end{center} +\end{figure} +\subsection*{Public Member Functions} +\begin{DoxyCompactItemize} +\item +\hyperlink{classBiblioIsisDb_ab2c5ec782b324847e104d8ad35a230af}{\_\-\_\-construct} (\$schema) +\item +\hyperlink{classBiblioIsisDb_a286fb16de5797785d28021068efca561}{logger} (\$message) +\item +\hyperlink{classBiblioIsisDb_ad5704f5c9454ac053e66a489797ba221}{backend} (\$method= 'count', \$args=NULL) +\item +\hyperlink{classBiblioIsisDb_a808cdbc0d4c8f62a1465e74064f4422f}{read} (\$id, \$method= 'fetch') +\item +\hyperlink{classBiblioIsisDb_ab6b0a977c066c25c6bdca5c1d3a083e8}{entries} () +\item +\hyperlink{classBiblioIsisDb_a8e76b289b9e3a9893b9469094753d2bc}{example} () +\item +\hyperlink{classBiblioIsisDb_a34483b463d81ba1d8031576b5735efbc}{tag} (\$results, \$method= 'fetch') +\item +\hyperlink{classBiblioIsisDb_a73d5d998f9ab7e410c5f71f65e83948b}{has\_\-subfields} (\$key) +\item +\hyperlink{classBiblioIsisDb_af0be305b211b96dcb4aeb8452c8331a9}{subfields\_\-switch} (\$key, \&\$value) +\item +\hyperlink{classBiblioIsisDb_a450e26ae0b7f4967d8e25c9a3d023c75}{subfields} (\$name, \$key, \$method) +\item +\hyperlink{classBiblioIsisDb_a8c6a0081c5296a6db520e98998502ef7}{subfields\_\-from\_\-to\_\-hash} (\$name, \$key) +\item +\hyperlink{classBiblioIsisDb_a2b08c6a7ba20f6f5eb07edb2b4a914c1}{subfields\_\-from\_\-fetch} (\$name, \$key) +\item +\hyperlink{classBiblioIsisDb_aa86380f9e66ea8f175c50675d1fe0a88}{is\_\-repetitive} (\$field, \$value) +\item +\hyperlink{classBiblioIsisDb_a04089d61ce04b18aa6a78c94ca02edb9}{repetition} (\$key, \$value) +\item +\hyperlink{classBiblioIsisDb_a2b6fd7b7316f63ac5649ebf3947c4fae}{charset} (\&\$data) +\end{DoxyCompactItemize} +\subsection*{Static Public Member Functions} +\begin{DoxyCompactItemize} +\item +static \hyperlink{classBiblioIsisDb_a929467f1907d3aeaeebe493f0c188c5b}{check} (\$schema, \$section=NULL) +\end{DoxyCompactItemize} +\subsection*{Public Attributes} +\begin{DoxyCompactItemize} +\item +\hyperlink{classBiblioIsisDb_a978a9243ea53b1f2426115d7b4191b07}{\$fdt} +\item +\hyperlink{classBiblioIsisDb_a7eccfa964dcd1469a263340447c38143}{\$perl} +\item +\hyperlink{classBiblioIsisDb_ab9fb3b6f10d2734a198ca7802ee38c2d}{\$format} +\item +\hyperlink{classBiblioIsisDb_a67337d78af0fc21d0ff10471aa638c62}{\$log} +\end{DoxyCompactItemize} + + +\subsection{Detailed Description} +Biblio::Isis implementation of \hyperlink{interfaceIsisDb}{IsisDb}. + +\subsection{Constructor \& Destructor Documentation} +\hypertarget{classBiblioIsisDb_ab2c5ec782b324847e104d8ad35a230af}{ +\index{BiblioIsisDb@{BiblioIsisDb}!\_\-\_\-construct@{\_\-\_\-construct}} +\index{\_\-\_\-construct@{\_\-\_\-construct}!BiblioIsisDb@{BiblioIsisDb}} +\subsubsection[{\_\-\_\-construct}]{\setlength{\rightskip}{0pt plus 5cm}BiblioIsisDb::\_\-\_\-construct (\$ {\em schema})}} +\label{classBiblioIsisDb_ab2c5ec782b324847e104d8ad35a230af} +Constructor. + +\begin{DoxySeeAlso}{See also} +\hyperlink{interfaceIsisDb_ae1c0a3496d55f710d34c5c19ada7a66b}{IsisDb::\_\-\_\-construct()} +\end{DoxySeeAlso} + + +Implements \hyperlink{interfaceIsisDb_ae1c0a3496d55f710d34c5c19ada7a66b}{IsisDb}. + + + +\subsection{Member Function Documentation} +\hypertarget{classBiblioIsisDb_ad5704f5c9454ac053e66a489797ba221}{ +\index{BiblioIsisDb@{BiblioIsisDb}!backend@{backend}} +\index{backend@{backend}!BiblioIsisDb@{BiblioIsisDb}} +\subsubsection[{backend}]{\setlength{\rightskip}{0pt plus 5cm}BiblioIsisDb::backend (\$ {\em method} = {\ttfamily 'count'}, \/ \$ {\em args} = {\ttfamily NULL})}} +\label{classBiblioIsisDb_ad5704f5c9454ac053e66a489797ba221} +Send requests to the perl backend. + + +\begin{DoxyParams}{Parameters} +\item[{\em \$method}]Backend method name to invoke.\item[{\em \$args}]Backend method arguments.\end{DoxyParams} +\begin{DoxyReturn}{Returns} +Backend return value. +\end{DoxyReturn} +\hypertarget{classBiblioIsisDb_a2b6fd7b7316f63ac5649ebf3947c4fae}{ +\index{BiblioIsisDb@{BiblioIsisDb}!charset@{charset}} +\index{charset@{charset}!BiblioIsisDb@{BiblioIsisDb}} +\subsubsection[{charset}]{\setlength{\rightskip}{0pt plus 5cm}BiblioIsisDb::charset (\&\$ {\em data})}} +\label{classBiblioIsisDb_a2b6fd7b7316f63ac5649ebf3947c4fae} +Charset conversion. + +Converts a string from the database charset to UTF-\/8. + + +\begin{DoxyParams}{Parameters} +\item[{\em \$data}]String to be converted.\end{DoxyParams} +\begin{DoxyReturn}{Returns} +String converted to UTF-\/8. +\end{DoxyReturn} +\hypertarget{classBiblioIsisDb_a929467f1907d3aeaeebe493f0c188c5b}{ +\index{BiblioIsisDb@{BiblioIsisDb}!check@{check}} +\index{check@{check}!BiblioIsisDb@{BiblioIsisDb}} +\subsubsection[{check}]{\setlength{\rightskip}{0pt plus 5cm}static BiblioIsisDb::check (\$ {\em schema}, \/ \$ {\em section} = {\ttfamily NULL})\hspace{0.3cm}{\ttfamily \mbox{[}static\mbox{]}}}} +\label{classBiblioIsisDb_a929467f1907d3aeaeebe493f0c188c5b} +Check configuration. + +\begin{DoxySeeAlso}{See also} +\hyperlink{interfaceIsisDb_af681b8f990b579f1835aa7ba4c83f1b8}{IsisDb::check()} +\end{DoxySeeAlso} + + +Implements \hyperlink{interfaceIsisDb_af681b8f990b579f1835aa7ba4c83f1b8}{IsisDb}. + +\hypertarget{classBiblioIsisDb_ab6b0a977c066c25c6bdca5c1d3a083e8}{ +\index{BiblioIsisDb@{BiblioIsisDb}!entries@{entries}} +\index{entries@{entries}!BiblioIsisDb@{BiblioIsisDb}} +\subsubsection[{entries}]{\setlength{\rightskip}{0pt plus 5cm}BiblioIsisDb::entries ()}} +\label{classBiblioIsisDb_ab6b0a977c066c25c6bdca5c1d3a083e8} +Return number of entries in the database. + +\begin{DoxySeeAlso}{See also} +\hyperlink{interfaceIsisDb_a86f38eca2b6d0835b60770d8a4e511ff}{IsisDb::entries()} +\end{DoxySeeAlso} + + +Implements \hyperlink{interfaceIsisDb_a86f38eca2b6d0835b60770d8a4e511ff}{IsisDb}. + +\hypertarget{classBiblioIsisDb_a8e76b289b9e3a9893b9469094753d2bc}{ +\index{BiblioIsisDb@{BiblioIsisDb}!example@{example}} +\index{example@{example}!BiblioIsisDb@{BiblioIsisDb}} +\subsubsection[{example}]{\setlength{\rightskip}{0pt plus 5cm}BiblioIsisDb::example ()}} +\label{classBiblioIsisDb_a8e76b289b9e3a9893b9469094753d2bc} +Return an example schema. + +\begin{DoxySeeAlso}{See also} +\hyperlink{interfaceIsisDb_a857c10d90da64067efa17afb2f32edb6}{IsisDb::example()} +\end{DoxySeeAlso} + + +Implements \hyperlink{interfaceIsisDb_a857c10d90da64067efa17afb2f32edb6}{IsisDb}. + +\hypertarget{classBiblioIsisDb_a73d5d998f9ab7e410c5f71f65e83948b}{ +\index{BiblioIsisDb@{BiblioIsisDb}!has\_\-subfields@{has\_\-subfields}} +\index{has\_\-subfields@{has\_\-subfields}!BiblioIsisDb@{BiblioIsisDb}} +\subsubsection[{has\_\-subfields}]{\setlength{\rightskip}{0pt plus 5cm}BiblioIsisDb::has\_\-subfields (\$ {\em key})}} +\label{classBiblioIsisDb_a73d5d998f9ab7e410c5f71f65e83948b} +Checks whether a field has subfields. + + +\begin{DoxyParams}{Parameters} +\item[{\em \$key}]Field key.\end{DoxyParams} +\begin{DoxyReturn}{Returns} +True if has subfields, false otherwise. +\end{DoxyReturn} +\hypertarget{classBiblioIsisDb_aa86380f9e66ea8f175c50675d1fe0a88}{ +\index{BiblioIsisDb@{BiblioIsisDb}!is\_\-repetitive@{is\_\-repetitive}} +\index{is\_\-repetitive@{is\_\-repetitive}!BiblioIsisDb@{BiblioIsisDb}} +\subsubsection[{is\_\-repetitive}]{\setlength{\rightskip}{0pt plus 5cm}BiblioIsisDb::is\_\-repetitive (\$ {\em field}, \/ \$ {\em value})}} +\label{classBiblioIsisDb_aa86380f9e66ea8f175c50675d1fe0a88} +Deals with repetition. + +As Biblio::Isis always return field values as arrays, we have to check the database schema to see if we want to convert then to a single value. + + +\begin{DoxyParams}{Parameters} +\item[{\em \$field}]Database field.\item[{\em \$value}]Data (with or without repetition).\end{DoxyParams} +\begin{DoxyReturn}{Returns} +True if repetitive, false otherwise. +\end{DoxyReturn} +\hypertarget{classBiblioIsisDb_a286fb16de5797785d28021068efca561}{ +\index{BiblioIsisDb@{BiblioIsisDb}!logger@{logger}} +\index{logger@{logger}!BiblioIsisDb@{BiblioIsisDb}} +\subsubsection[{logger}]{\setlength{\rightskip}{0pt plus 5cm}BiblioIsisDb::logger (\$ {\em message})}} +\label{classBiblioIsisDb_a286fb16de5797785d28021068efca561} +Class logger. + + +\begin{DoxyParams}{Parameters} +\item[{\em \$message}]Log message. \end{DoxyParams} +\hypertarget{classBiblioIsisDb_a808cdbc0d4c8f62a1465e74064f4422f}{ +\index{BiblioIsisDb@{BiblioIsisDb}!read@{read}} +\index{read@{read}!BiblioIsisDb@{BiblioIsisDb}} +\subsubsection[{read}]{\setlength{\rightskip}{0pt plus 5cm}BiblioIsisDb::read (\$ {\em id}, \/ \$ {\em method} = {\ttfamily 'fetch'})}} +\label{classBiblioIsisDb_a808cdbc0d4c8f62a1465e74064f4422f} +Read an entry. + + +\begin{DoxyParams}{Parameters} +\item[{\em \$id}]Record Id.\item[{\em \$method}]Database read method.\end{DoxyParams} +\begin{DoxySeeAlso}{See also} +\hyperlink{interfaceIsisDb_a68335ec0db01ef03f0725621b38b5686}{IsisDb::read()} +\end{DoxySeeAlso} +\hypertarget{classBiblioIsisDb_a04089d61ce04b18aa6a78c94ca02edb9}{ +\index{BiblioIsisDb@{BiblioIsisDb}!repetition@{repetition}} +\index{repetition@{repetition}!BiblioIsisDb@{BiblioIsisDb}} +\subsubsection[{repetition}]{\setlength{\rightskip}{0pt plus 5cm}BiblioIsisDb::repetition (\$ {\em key}, \/ \$ {\em value})}} +\label{classBiblioIsisDb_a04089d61ce04b18aa6a78c94ca02edb9} +Deals with repetition. + +As Biblio::Isis always return field values as arrays, we have to check the database schema to see if we want to convert then to a single value. The current implementation is just a placeholder as no conversion is done. + + +\begin{DoxyParams}{Parameters} +\item[{\em \$key}]Database key.\item[{\em \$value}]Query field result.\end{DoxyParams} +\begin{DoxyReturn}{Returns} +The value according to the repetition config. +\end{DoxyReturn} +\hypertarget{classBiblioIsisDb_a450e26ae0b7f4967d8e25c9a3d023c75}{ +\index{BiblioIsisDb@{BiblioIsisDb}!subfields@{subfields}} +\index{subfields@{subfields}!BiblioIsisDb@{BiblioIsisDb}} +\subsubsection[{subfields}]{\setlength{\rightskip}{0pt plus 5cm}BiblioIsisDb::subfields (\$ {\em name}, \/ \$ {\em key}, \/ \$ {\em method})}} +\label{classBiblioIsisDb_a450e26ae0b7f4967d8e25c9a3d023c75} +Makes subfield substitution in a dataset. + + +\begin{DoxyParams}{Parameters} +\item[{\em \$name}]Dataset.\item[{\em \$key}]Field key.\item[{\em \$method}]Database read method.\end{DoxyParams} +\begin{DoxyReturn}{Returns} +Data with processed subfields. +\end{DoxyReturn} +\hypertarget{classBiblioIsisDb_a2b08c6a7ba20f6f5eb07edb2b4a914c1}{ +\index{BiblioIsisDb@{BiblioIsisDb}!subfields\_\-from\_\-fetch@{subfields\_\-from\_\-fetch}} +\index{subfields\_\-from\_\-fetch@{subfields\_\-from\_\-fetch}!BiblioIsisDb@{BiblioIsisDb}} +\subsubsection[{subfields\_\-from\_\-fetch}]{\setlength{\rightskip}{0pt plus 5cm}BiblioIsisDb::subfields\_\-from\_\-fetch (\$ {\em name}, \/ \$ {\em key})}} +\label{classBiblioIsisDb_a2b08c6a7ba20f6f5eb07edb2b4a914c1} +Subfield handling for data read by 'from\_\-fetch' method. + + +\begin{DoxyParams}{Parameters} +\item[{\em \$name}]Dataset.\item[{\em \$key}]Field key.\end{DoxyParams} +\begin{DoxyReturn}{Returns} +Data with processed subfields. +\end{DoxyReturn} +\hypertarget{classBiblioIsisDb_a8c6a0081c5296a6db520e98998502ef7}{ +\index{BiblioIsisDb@{BiblioIsisDb}!subfields\_\-from\_\-to\_\-hash@{subfields\_\-from\_\-to\_\-hash}} +\index{subfields\_\-from\_\-to\_\-hash@{subfields\_\-from\_\-to\_\-hash}!BiblioIsisDb@{BiblioIsisDb}} +\subsubsection[{subfields\_\-from\_\-to\_\-hash}]{\setlength{\rightskip}{0pt plus 5cm}BiblioIsisDb::subfields\_\-from\_\-to\_\-hash (\$ {\em name}, \/ \$ {\em key})}} +\label{classBiblioIsisDb_a8c6a0081c5296a6db520e98998502ef7} +Subfield handling for data read by 'to\_\-hash' method. This method is not fully supported and therefore not recommended. + +It does not deal very well when data has \char`\"{}main\char`\"{} fields and subfields (like \char`\"{}data1$^\wedge$adata2$^\wedge$bdata3\char`\"{}) and doesn't deal with advanced configuration such as 'join\_\-subfields'. + + +\begin{DoxyParams}{Parameters} +\item[{\em \$name}]Dataset.\item[{\em \$key}]Field key.\end{DoxyParams} +\begin{DoxyReturn}{Returns} +Data with processed subfields. +\end{DoxyReturn} +\hypertarget{classBiblioIsisDb_af0be305b211b96dcb4aeb8452c8331a9}{ +\index{BiblioIsisDb@{BiblioIsisDb}!subfields\_\-switch@{subfields\_\-switch}} +\index{subfields\_\-switch@{subfields\_\-switch}!BiblioIsisDb@{BiblioIsisDb}} +\subsubsection[{subfields\_\-switch}]{\setlength{\rightskip}{0pt plus 5cm}BiblioIsisDb::subfields\_\-switch (\$ {\em key}, \/ \&\$ {\em value})}} +\label{classBiblioIsisDb_af0be305b211b96dcb4aeb8452c8331a9} +Switch keys on subfields. + + +\begin{DoxyParams}{Parameters} +\item[{\em \$key}]Field key.\item[{\em \$value}]Dataset. \end{DoxyParams} +\hypertarget{classBiblioIsisDb_a34483b463d81ba1d8031576b5735efbc}{ +\index{BiblioIsisDb@{BiblioIsisDb}!tag@{tag}} +\index{tag@{tag}!BiblioIsisDb@{BiblioIsisDb}} +\subsubsection[{tag}]{\setlength{\rightskip}{0pt plus 5cm}BiblioIsisDb::tag (\$ {\em results}, \/ \$ {\em method} = {\ttfamily 'fetch'})}} +\label{classBiblioIsisDb_a34483b463d81ba1d8031576b5735efbc} +Tag results of a db query. + +This function converts the keys of query result from field numbers to names. + + +\begin{DoxyParams}{Parameters} +\item[{\em \$results}]Database query results.\item[{\em \$method}]Database read method.\end{DoxyParams} +\begin{DoxyReturn}{Returns} +Tagged database result. +\end{DoxyReturn} + + +\subsection{Member Data Documentation} +\hypertarget{classBiblioIsisDb_a978a9243ea53b1f2426115d7b4191b07}{ +\index{BiblioIsisDb@{BiblioIsisDb}!\$fdt@{\$fdt}} +\index{\$fdt@{\$fdt}!BiblioIsisDb@{BiblioIsisDb}} +\subsubsection[{\$fdt}]{\setlength{\rightskip}{0pt plus 5cm}BiblioIsisDb::\$fdt}} +\label{classBiblioIsisDb_a978a9243ea53b1f2426115d7b4191b07} +Field description table. \hypertarget{classBiblioIsisDb_ab9fb3b6f10d2734a198ca7802ee38c2d}{ +\index{BiblioIsisDb@{BiblioIsisDb}!\$format@{\$format}} +\index{\$format@{\$format}!BiblioIsisDb@{BiblioIsisDb}} +\subsubsection[{\$format}]{\setlength{\rightskip}{0pt plus 5cm}BiblioIsisDb::\$format}} +\label{classBiblioIsisDb_ab9fb3b6f10d2734a198ca7802ee38c2d} +Database format, derived from \$schema. \hypertarget{classBiblioIsisDb_a67337d78af0fc21d0ff10471aa638c62}{ +\index{BiblioIsisDb@{BiblioIsisDb}!\$log@{\$log}} +\index{\$log@{\$log}!BiblioIsisDb@{BiblioIsisDb}} +\subsubsection[{\$log}]{\setlength{\rightskip}{0pt plus 5cm}BiblioIsisDb::\$log}} +\label{classBiblioIsisDb_a67337d78af0fc21d0ff10471aa638c62} +Class action log. \hypertarget{classBiblioIsisDb_a7eccfa964dcd1469a263340447c38143}{ +\index{BiblioIsisDb@{BiblioIsisDb}!\$perl@{\$perl}} +\index{\$perl@{\$perl}!BiblioIsisDb@{BiblioIsisDb}} +\subsubsection[{\$perl}]{\setlength{\rightskip}{0pt plus 5cm}BiblioIsisDb::\$perl}} +\label{classBiblioIsisDb_a7eccfa964dcd1469a263340447c38143} +Class instance of a perl interpreter; + +The documentation for this class was generated from the following file:\begin{DoxyCompactItemize} +\item +classes/backends/BiblioIsisDb.php\end{DoxyCompactItemize} |