publicdata/nih-gov
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
nih-gov/www.ncbi.nlm.nih.gov/mailman/pipermail/cpp-announce/2001/000046.html

168 lines
8.1 KiB
HTML
Raw Blame History

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<HEAD>
<TITLE> [C++ Toolkit ANNOUNCE] BIG! New NCBI network client API.
</TITLE>
<LINK REL="Index" HREF="index.html" >
<LINK REL="made" HREF="mailto:cpp-announce%40ncbi.nlm.nih.gov?Subject=%5BC%2B%2B%20Toolkit%20ANNOUNCE%5D%20BIG%21%20%20New%20NCBI%20network%20client%20API.&In-Reply-To=">
<META NAME="robots" CONTENT="index,nofollow">
<META http-equiv="Content-Type" content="text/html; charset=us-ascii">
<LINK REL="Previous" HREF="000045.html">
<LINK REL="Next" HREF="000047.html">
</HEAD>
<BODY BGCOLOR="#ffffff">
<H1>[C++ Toolkit ANNOUNCE] BIG! New NCBI network client API.</H1>
<!--htdig_noindex-->
<B>Denis Vakatov</B>
<A HREF="mailto:cpp-announce%40ncbi.nlm.nih.gov?Subject=%5BC%2B%2B%20Toolkit%20ANNOUNCE%5D%20BIG%21%20%20New%20NCBI%20network%20client%20API.&In-Reply-To="
TITLE="[C++ Toolkit ANNOUNCE] BIG! New NCBI network client API.">vakatov at ncbi.nlm.nih.gov
</A><BR>
<I>Mon Jul 16 12:34:11 EDT 2001</I>
<P><UL>
<LI>Previous message: <A HREF="000045.html">[C++ Toolkit ANNOUNCE] &lt;corelib/ncbi_system.hpp&gt; -- SetHeapLimit() and SetCpuTimeLimit()
</A></li>
<LI>Next message: <A HREF="000047.html">[C++ Toolkit ANNOUNCE] NCBI C++ Toolkit SNAPSHOT
</A></li>
<LI> <B>Messages sorted by:</B>
<a href="date.html#46">[ date ]</a>
<a href="thread.html#46">[ thread ]</a>
<a href="subject.html#46">[ subject ]</a>
<a href="author.html#46">[ author ]</a>
</LI>
</UL>
<HR>
<!--/htdig_noindex-->
<!--beginarticle-->
<PRE>FYI,
We have got ourselves a new NCBI network client API, which is based on the
new NCBI dispatcher and load-balancer -- all re-written, refined and
dramatically extended in functionality!
The primary purporse of this API is to provide a seamless
connection to the NCBI network services.
NOTE: this API also implements numerous &quot;generic&quot; functionalities,
which are not &quot;NCBI specific&quot;, such as portable socket and HTTP
connection (which also can be converted to the C++ i/o streams),
simple heap manager, data buffering, sendmail, etc.
Without getting into too much details: the new client API has
superior multi-layered design, extended functionality, is way more flexible
and configurable, and it eliminates numerous restrictions, oddities
and not-transparency of the old NCBI network API. [;-)))]
Its core functionality is implemented in &quot;C&quot;, and there are some
auxiliary &quot;C++&quot; interfaces as well.
The &quot;C&quot; part is shared between the C and C++ NCBI Toolkits -- there
is a separate &quot;connect&quot; library in the C++ Toolkit, which also is a
part of &quot;ncbi&quot; library of the C Toolkit (this code is 100% identical
in the Toolkits).
The &quot;C&quot; part is also 100% included into the &quot;xconnect&quot; library, which
adds &quot;C++&quot; API.
You can find its brief description in:
<A HREF="http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/libs/conn.html">http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/libs/conn.html</A>
[&quot;C&quot; programmers]
A very simple example (for the &quot;bounce&quot; service that does nothing
but bounces back all incoming data):
<A HREF="http://www.ncbi.nlm.nih.gov/IEB/ToolBox/C_DOC/lxr/source/connect/test/test_ncbi_service_connector.c">http://www.ncbi.nlm.nih.gov/IEB/ToolBox/C_DOC/lxr/source/connect/test/test_ncbi_service_connector.c</A>
A helper API to create &quot;AsnIoPtr&quot; based on &quot;CONN&quot; or
directly on name of the service:
<A HREF="http://www.ncbi.nlm.nih.gov/IEB/ToolBox/C_DOC/lxr/source/connect/asn_connection.h">http://www.ncbi.nlm.nih.gov/IEB/ToolBox/C_DOC/lxr/source/connect/asn_connection.h</A>
The new API is already in the NCBI C Toolkit Release from July 9:
<A HREF="ftp://ftp.ncbi.nlm.nih.gov/toolbox/ncbi_tools/CURRENT/">ftp://ftp.ncbi.nlm.nih.gov/toolbox/ncbi_tools/CURRENT/</A>
It's pretty stable already, and we have already started to use it
internally.
[ &quot;C/C++&quot; programmers ]
There is a helper API to create C++ I/O stream based on &quot;CONN&quot; or
directly on the service name:
<A HREF="http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/lxr/source/include/connect/ncbi_conn_stream.hpp">http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/lxr/source/include/connect/ncbi_conn_stream.hpp</A>
You then can attach the standard C++ I/O stream to the NCBI
serialization stream, and i/o data in ASN.1 or XML format:
<A HREF="http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/programming_manual/asn.html">http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/programming_manual/asn.html</A>
A good example of such application is ID1_FETCH:
<A HREF="http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/lxr/source/src/app/id1_fetch/id1_fetch.cpp">http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/lxr/source/src/app/id1_fetch/id1_fetch.cpp</A>
DISCLAIMER / ENTICEMENT:
All the above is, of course, just for a brief announcement.
More docs are due (and some already exist) on this.
However, an inquisitive mind can IMHO &quot;figure out&quot; and start using
this API already, provided with:
- even that small amount of docs:
<A HREF="http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/libs/conn.html">http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/libs/conn.html</A>
- and especially:
1) the API headers (which contain a lot of end-user interfaces and
extended comments), such as:
<A HREF="http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/lxr/source/include/connect/ncbi_connection.h">http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/lxr/source/include/connect/ncbi_connection.h</A>
<A HREF="http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/lxr/source/include/connect/ncbi_service_connector.h">http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/lxr/source/include/connect/ncbi_service_connector.h</A>
<A HREF="http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/lxr/source/include/connect/ncbi_conn_stream.hpp">http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/lxr/source/include/connect/ncbi_conn_stream.hpp</A>
and others...
2) tests:
<A HREF="http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/lxr/source/src/connect/test/test_ncbi_service_connector.c">http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/lxr/source/src/connect/test/test_ncbi_service_connector.c</A>
<A HREF="http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/lxr/source/src/connect/test/test_ncbi_conn_stream.cpp">http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/lxr/source/src/connect/test/test_ncbi_conn_stream.cpp</A>
and others...
3) demo:
<A HREF="http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/lxr/source/src/app/id1_fetch/id1_fetch.cpp">http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/lxr/source/src/app/id1_fetch/id1_fetch.cpp</A>
Good luck,
Denis, Anton
P.S. We are planning to make the next pre-release of the NCBI C++
Toolkit (for all platforms) in a day or two.
Credits:
Anton Lavrentiev (<A HREF="http://www.ncbi.nlm.nih.gov/mailman/listinfo/cpp-announce">lavr at ncbi.nlm.nih.gov</A>)
The new NCBI network dispatcher, including load-balancer.
Most of the client API.
Denis Vakatov (<A HREF="http://www.ncbi.nlm.nih.gov/mailman/listinfo/cpp-announce">vakatov at ncbi.nlm.nih.gov</A>)
Overall project supervision. Parts of the client API.
NCBI &quot;firewal daemon&quot;.
Debits:
None so far... :-)))
</PRE>
<!--endarticle-->
<!--htdig_noindex-->
<HR>
<P><UL>
<!--threads-->
<LI>Previous message: <A HREF="000045.html">[C++ Toolkit ANNOUNCE] &lt;corelib/ncbi_system.hpp&gt; -- SetHeapLimit() and SetCpuTimeLimit()
</A></li>
<LI>Next message: <A HREF="000047.html">[C++ Toolkit ANNOUNCE] NCBI C++ Toolkit SNAPSHOT
</A></li>
<LI> <B>Messages sorted by:</B>
<a href="date.html#46">[ date ]</a>
<a href="thread.html#46">[ thread ]</a>
<a href="subject.html#46">[ subject ]</a>
<a href="author.html#46">[ author ]</a>
</LI>
</UL>
<hr>
<a href="http://www.ncbi.nlm.nih.gov/mailman/listinfo/cpp-announce">More information about the cpp-announce
mailing list</a><br>
<!--/htdig_noindex-->
</body></html>
Reference in a new issue View git blame Copy permalink