ComposantsComponents › InternetInternet
Se connecte à un port TCP, en général celui d'un tSocketInput qui attend dans un autre job, et y envoie les lignes de son flux sous forme de texte délimité (comme un fichier CSV), une à une, puis ferme la connexion à la fin du sous-job. Si personne n'écoute encore, il réessaie plusieurs fois. Ni chiffrement ni authentification. Connects to a TCP port, usually the one of a tSocketInput waiting in another job, and sends the rows of its flow there as delimited text (like a CSV file), one by one, then closes the connection at the end of the subjob. When nobody listens yet, it tries again several times. No encryption, no authentication.
EntréeInput
Main les lignes à envoyer.the rows to send.
SortieOutput
Un lien Main facultatif : les lignes reçues, transmises telles quelles après leur envoi.An optional Main link: the received rows, passed on as they are after being sent.
Déclencheurs en sortieOutput triggers
On Subjob Ok On Subjob Error On Component Ok On Component Error Run if
Les lignes vont au tSocketInput d'un autre job, lancé avant lui ou peu après (le temps des nouvelles tentatives). Le tJava affiche NB_LINE.
The rows go to the tSocketInput of another job, started before it or shortly after (within the time of the new tries). The tJava prints NB_LINE.
Avec Exécution multi thread cochée dans les réglages du job (page Extra), les deux sous-jobs démarrent ensemble ; si l'envoi part avant que le port soit ouvert, il est refusé puis réessayé une seconde plus tard. Sortie de ce job : voir les exemples du tSocketInput. With Multi thread execution checked in the job settings (Extra page), both subjobs start together; when the sending starts before the port is opened, it is refused then tried again one second later. Output of this job: see the examples of the tSocketInput.
"UTF-8" des deux côtés.
Give the same separators, enclosure, encoding and compression as the tSocketInput; prefer "UTF-8" on both sides.
Les libellés sont ceux de l'onglet Composant, dans son ordre ; le nom technique, en gris, est celui du paramètre dans le fichier du job. Le composant n'a pas de paramètres avancés propres. Les séparateurs, le caractère d'échappement et l'entourage sont des textes entre guillemets d'un seul caractère. Labels are those of the Component tab, in its order; the technical name, in grey, is the parameter name in the job file. The component has no advanced settings of its own. The separators, the escape character and the enclosure are texts in quotes of a single character.
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| HôteHostHOST | "127.0.0.1" |
ToujoursAlways | Nom ou adresse de la machine du tSocketInput, entre guillemets. Name or address of the machine of the tSocketInput, in quotes. |
| PortPORT | 3456 |
ToujoursAlways | Le Port du tSocketInput, expression Java entière. The Port of the tSocketInput, integer Java expression. |
| CompresserCompressCOMPRESS | NonNo | ToujoursAlways | Chaque valeur est compressée (zip) puis codée en Base64, sur des lignes de 76 caractères. Le tSocketInput doit avoir Décompresser coché et un entourage. Cela n'allège que les longues valeurs : une ligne de quatre valeurs courtes est passée de 31 à 829 octets (voir Ce qui est envoyé). Each value is compressed (zip) then coded in Base64, in lines of 76 characters. The tSocketInput must have Uncompress checked and an enclosure. It only lightens long values: a row of four short values went from 31 to 829 bytes (see What is sent). |
| Nombre d'essaisRetry TimesRETRY | 10 |
ToujoursAlways |
Le composant fait une tentative de moins que ce nombre : 9 avec 10. Avec 1 (ou moins), il n'en fait aucune et échoue sur une NullPointerException (voir La connexion). Seul un refus de connexion est réessayé.
The component makes one try fewer than this number: 9 with 10. With 1 (or less), it makes none and fails on a NullPointerException (see The connection). Only a refused connection is tried again.
|
| Délai avant expirationTimeoutTIMEOUT | 1000 |
ToujoursAlways | Pause, en millisecondes, après chaque tentative refusée, y compris la dernière. Ce n'est pas un délai de connexion : la connexion elle-même n'a pas de délai réglé (lu dans le modèle). Pause, in milliseconds, after each refused try, including the last one. This is not a connection timeout: the connection itself has no timeout set (read in the template). |
| Séparateur de lignesRow SeparatorROWSEPARATOR | "\n" |
ToujoursAlways |
"\n" et "\r" envoient la fin de ligne du système qui exécute le job : \r\n sous Windows (mesuré pour les deux). Un autre caractère ("#") : ce caractère. Deux caractères ("\r\n") font échouer la compilation.
"\n" and "\r" send the line end of the system that runs the job: \r\n on Windows (measured for both). Another character ("#"): that character. Two characters ("\r\n") make the compilation fail.
|
| Séparateur de champsField SeparatorFIELDSEPARATOR | ";" |
ToujoursAlways |
Un caractère : ";", "|", "\t".
One character: ";", "|", "\t".
|
| Caractère d'échappementEscape charESCAPE_CHAR | "\"" |
ToujoursAlways |
"\\" : un guillemet dans une valeur est précédé d'une barre oblique inverse. Toute autre valeur : il est doublé.
"\\": a quote in a value is preceded by a backslash. Any other value: it is doubled.
|
| Entourage du texteText enclosureTEXT_ENCLOSURE | "\"" |
ToujoursAlways | Renseigné : toutes les valeurs sont entourées, nombres et valeurs vides compris. Vide : aucune ne l'est et rien n'est échappé ; une valeur qui contient le séparateur décale alors les champs à la réception. Filled in: all the values are enclosed, numbers and empty values included. Empty: none is and nothing is escaped; a value that holds the separator then shifts the fields at the reception. |
| SchémaSchemaSCHEMA | celui du fluxthe one of the flow | ToujoursAlways |
Chaque colonne devient un champ : null s'envoie vide ; une Date avec un motif est écrite avec ce motif ; les autres valeurs en texte Java. Lu dans le modèle : une Date sans motif part sous la forme Thu Jan 15 00:00:00 CET 2026, un tableau d'octets est décodé avec l'encodage par défaut de Java et non avec l'Encodage.
Each column becomes a field: null is sent empty; a Date with a pattern is written with this pattern; the other values as Java text. Read in the template: a Date without a pattern goes out as Thu Jan 15 00:00:00 CET 2026, a byte array is decoded with the default encoding of Java and not with the Encoding.
|
| EncodageEncodingENCODING | "ISO-8859-15" |
ToujoursAlways |
Encodage des octets envoyés ; un caractère qu'il ne connaît pas part en ?. Le même qu'au tSocketInput (voir l'encodage du tSocketInput).
Encoding of the sent bytes; a character it does not know goes out as ?. The same as at the tSocketInput (see the encoding of the tSocketInput).
|
((Integer) globalMap.get("tSocketOutput_1_NB_LINE"))
Le job qui envoie, vers un serveur d'essai qui journalise les octets reçus à la place d'un tSocketInput. Le journal coupe les octets à chaque \n et les montre en notation Python : \r est un retour chariot, \xe9 l'octet E9, \\ une seule barre oblique inverse. Schéma id (Integer), name, city, since (Date, motif "yyyy-MM-dd") ; les lignes :
The job that sends, to a test server that logs the received bytes instead of a tSocketInput. The log cuts the bytes at each \n and shows them in Python notation: \r is a carriage return, \xe9 the E9 byte, \\ a single backslash. Schema id (Integer), name, city, since (Date, pattern "yyyy-MM-dd"); the rows:
id name city since
1 "Zoé" "Lyon" TalendDate.parseDate("yyyy-MM-dd", "2026-01-15")
2 "Grace; \"Amazing\"" "New York" TalendDate.parseDate("yyyy-MM-dd", "2025-06-01")
3 "Ada" null null
[tcplog] connection from 127.0.0.1:65378 [tcplog] closed by client after 98 bytes [tcplog] b'"1";"Zo\xe9";"Lyon";"2026-01-15"\r' [tcplog] b'"2";"Grace; ""Amazing""";"New York";"2025-06-01"\r' [tcplog] b'"3";"Ada";"";""\r' [tcplog] b''
Tout est entouré de guillemets, les guillemets de la valeur sont doublés, chaque ligne finit par \r\n, le « é » est l'octet E9 de l'ISO-8859-15, les null sont vides.
Everything is enclosed in quotes, the quotes of the value are doubled, each row ends with \r\n, the "é" is the E9 byte of ISO-8859-15, the null values are empty.
Séparateur de champs "|", de lignes "#", Entourage du texte "", Encodage "UTF-8".
Field Separator "|", Row Separator "#", Text enclosure "", Encoding "UTF-8".
[tcplog] connection from 127.0.0.1:49302 [tcplog] closed by client after 70 bytes [tcplog] b'1|Zo\xc3\xa9|Lyon|2026-01-15#2|Grace; "Amazing"|New York|2025-06-01#3|Ada||#'
Les valeurs partent brutes, guillemets compris ; le « é » prend deux octets en UTF-8. Avec ces séparateurs et l'UTF-8 des deux côtés, mais l'entourage par défaut, un tSocketInput a relu les trois lignes correctement. The values go out raw, quotes included; the "é" takes two bytes in UTF-8. With these separators and UTF-8 on both sides, but the default enclosure, a tSocketInput read the three rows back correctly.
Caractère d'échappement "\\", la deuxième ligne seule.
Escape char "\\", the second row only.
[tcplog] connection from 127.0.0.1:62067 [tcplog] closed by client after 50 bytes [tcplog] b'"2";"Grace; \\"Amazing\\"";"New York";"2025-06-01"\r' [tcplog] b''
"\r""\r" row separatorLa première ligne seule. The first row only.
[tcplog] connection from 127.0.0.1:57280 [tcplog] closed by client after 31 bytes [tcplog] b'"1";"Zo\xe9";"Lyon";"2026-01-15"\r' [tcplog] b''
Le même \r\n qu'avec "\n" : 29 octets de valeurs et 2 de fin de ligne.
The same \r\n as with "\n": 29 bytes of values and 2 of line end.
Compresser cochée, la première ligne seule (31 octets sans compression) : Compress checked, the first row only (31 bytes without compression):
[tcplog] connection from 127.0.0.1:63860 [tcplog] closed by client after 829 bytes [tcplog] b'"UEsDBBQACAgIAFd9dV0AAAAAAAAAAAAAAAAOAAAAc2VydmxldHNlcnZpY2UzBABQSwcIt+/cgwMA\r' [tcplog] b'AAABAAAAUEsBAhQAFAAICAgAV311Xbfv3IMDAAAAAQAAAA4AAAAAAAAAAAAAAAAAAAAAAHNlcnZs\r' [tcplog] b'ZXRzZXJ2aWNlUEsFBgAAAAABAAEAPAAAAD8AAAAAAA==";"UEsDBBQACAgIAFd9dV0AAAAAAAAAAAAAAAAOAAAAc2VydmxldHNlcnZpY2WLyn8JAFBLBwjAX9ml\r' [tcplog] b'BQAAAAMAAABQSwECFAAUAAgICABXfXVdwF/ZpQUAAAADAAAADgAAAAAAAAAAAAAAAAAAAAAAc2Vy\r' [tcplog] b'dmxldHNlcnZpY2VQSwUGAAAAAAEAAQA8AAAAQQAAAAAA";"UEsDBBQACAgIAFd9dV0AAAAAAAAAAAAAAAAOAAAAc2VydmxldHNlcnZpY2XzqczPAwBQSwcIcVDJ\r' [tcplog] b'4wYAAAAEAAAAUEsBAhQAFAAICAgAV311XXFQyeMGAAAABAAAAA4AAAAAAAAAAAAAAAAAAAAAAHNl\r' [tcplog] b'cnZsZXRzZXJ2aWNlUEsFBgAAAAABAAEAPAAAAEIAAAAAAA==";"UEsDBBQACAgIAFd9dV0AAAAAAAAAAAAAAAAOAAAAc2VydmxldHNlcnZpY2UzMjAy0zUw1DU0BQBQ\r' [tcplog] b'SwcIQRkZXwwAAAAKAAAAUEsBAhQAFAAICAgAV311XUEZGV8MAAAACgAAAA4AAAAAAAAAAAAAAAAA\r' [tcplog] b'AAAAAHNlcnZsZXRzZXJ2aWNlUEsFBgAAAAABAAEAPAAAAEgAAAAAAA=="\r' [tcplog] b''
Chaque valeur est une archive zip complète (une entrée nommée servletservice), codée en Base64 avec des retours à la ligne \r\n tous les 76 caractères : sans entourage, ces retours coupent la ligne et le tSocketInput échoue sur java.io.EOFException.
Each value is a full zip archive (one entry named servletservice), coded in Base64 with \r\n line breaks every 76 characters: without enclosure, these breaks cut the row and the tSocketInput fails on java.io.EOFException.
La connexion est ouverte au début du sous-job, avant la première ligne. Refusée (personne n'écoute), elle est retentée après une pause d'un Délai avant expiration ; les autres erreurs (nom d'hôte inconnu…) font échouer le composant tout de suite. Après la dernière tentative, le composant échoue sur le refus. Chaque ligne est envoyée dès qu'elle arrive ; la connexion est fermée à la fin du sous-job, ce qui termine la réception du tSocketInput. The connection is opened at the start of the subjob, before the first row. Refused (nobody listening), it is tried again after a pause of one Timeout; the other errors (unknown host name…) make the component fail at once. After the last try, the component fails on the refusal. Each row is sent as soon as it arrives; the connection is closed at the end of the subjob, which ends the reception of the tSocketInput.
Le job qui envoie, vers un port libre, avec un tJava relié par On Component Error qui affiche le message ; Nombre d'essais 3, Délai avant expiration 500. Nom du job remplacé par MyJob, pile abrégée :
The job that sends, to a free port, with a tJava connected with On Component Error that prints the message; Retry Times 3, Timeout 500. Job name replaced with MyJob, shortened stack:
Exception in component tSocketOutput_1 (MyJob) java.net.ConnectException: Connection refused: connect at java.base/sun.nio.ch.Net.connect0(Native Method) … at java.base/java.net.Socket.<init>(Socket.java:324) at demo.myjob_0_1.MyJob.tFixedFlowInput_1Process(MyJob.java:914) … On Component Error: ERROR_MESSAGE = Connection refused: connect
Le job entier a duré 3,4 s, préparation comprise ; avec les réglages par défaut, le même message est venu au bout de 11,6 s : 9 tentatives et 9 pauses d'une seconde. Le tJava relié par On Subjob Ok ne s'exécute pas. The whole job took 3.4 s, preparation included; with the default settings, the same message came after 11.6 s: 9 tries and 9 one-second pauses. The tJava connected with On Subjob Ok does not run.
Le même job, Nombre d'essais 1 :
The same job, Retry Times 1:
Exception in component tSocketOutput_1 (MyJob) java.lang.NullPointerException: Cannot invoke "java.net.Socket.getOutputStream()" because "<local9>" is null at demo.myjob_0_1.MyJob.tFixedFlowInput_1Process(MyJob.java:930) … On Component Error: ERROR_MESSAGE = Cannot invoke "java.net.Socket.getOutputStream()" because "<local9>" is null
La boucle des tentatives va jusqu'au nombre moins un : avec 1, aucune tentative n'est faite, et le composant échoue même si un tSocketInput attend. Mettez au moins 2 pour une seule tentative.
The loop of tries goes up to the number minus one: with 1, no try is made, and the component fails even when a tSocketInput is waiting. Set at least 2 for a single try.
Le composant ne reçoit aucune réponse : il se termine sans erreur dès que ses lignes sont écrites. Lors de nos essais, un second tSocketOutput connecté au même tSocketInput a fini avec NB_LINE = 1 alors que sa ligne a été perdue (voir les pièges du tSocketInput). Comparez le NB_LINE des deux bouts quand la perte compte.
The component receives no answer: it ends without an error as soon as its rows are written. In our runs, a second tSocketOutput connected to the same tSocketInput ended with NB_LINE = 1 while its row was lost (see the pitfalls of the tSocketInput). Compare the NB_LINE of both ends when a loss matters.
Les lignes circulent sans chiffrement et le composant ne vérifie pas à qui il parle : tout programme qui écoute sur l'hôte et le port donnés les reçoit. Réservez-le à une même machine ("127.0.0.1") ou à un réseau de confiance (voir la sécurité du tSocketInput).
The rows travel without encryption and the component does not check whom it talks to: any program that listens on the given host and port receives them. Keep it for a single machine ("127.0.0.1") or a trusted network (see the security of the tSocketInput).
Les séparateurs, l'entourage et l'échappement sont écrits dans le code comme des caractères Java. Séparateur de lignes "\r\n" a fait échouer la compilation du job (unclosed character literal sur setLineEnd(""+'\r\n')) ; laissez "\n", qui envoie déjà \r\n sous Windows.
The separators, the enclosure and the escape are written in the code as Java characters. Row Separator "\r\n" made the compilation of the job fail (unclosed character literal on setLineEnd(""+'\r\n')); leave "\n", which already sends \r\n on Windows.
Le texte du composant dans la palette (« Lit un fichier ligne par ligne avec des champs simple séparés ») et plusieurs libellés de ses traductions viennent d'un composant de lecture de fichier : ils ne décrivent pas le tSocketOutput. The text of the component in the palette ("Reads a file row by row with simple separated fields") and several labels of its translations come from a file-reading component: they do not describe the tSocketOutput.
Les autres composants de la famille Internet, et ceux qui servent avec le tSocketOutput : The other components of the Internet family, and those used with the tSocketOutput:
tSocketInput · reçoit les lignes envoyéesreceives the sent rowstParallelize · lance envoi et réception en même tempsstarts sending and reception at the same timetFileOutputDelimited · les mêmes options de séparateurs, vers un fichierthe same separator options, to a filetRunJob · passe des lignes à un autre job du même projetpasses rows to another job of the same projecttFixedFlowInput · fournit les lignes des exemplesprovides the rows of the examplestJava · affiche NB_LINEprints NB_LINE